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• Adventure Helpline • 

• Exploring the 1541 • 

• Inside Basic Memory • 



Don't go around in 
circles keeping track of 
your money 
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NOW IS THE TIME 

TO CATCH UP ON ISSUES 
YOU HAVE MISSED 



VOL 2 No.5 IUL/AUG '89 
FONT FACTORY - Create your 

HIRES DEMO KIT - Add music 

to your favourite picture. 

ANIMATOR - Get those sprites 

moving 

BORDER MESSAGE SCROLL - 

Say what you like along Ihe 

bottom of the screen. 

TYPIT-128 - Create professional 

text layoul on yourC12B 

SCREEN COPIES UTILITY 

Download your favourite 

screens, including CDU paint 

files. 

VIDI-BASIC - Graphic based 

extension to Basic. 

64 NEWS DESK - Become a 

C64 reporter. 



VOL 2 No.b SEP/OCT '89 
MICKMON - An extensive M/C 



SCRAPBOOK - Collectors and 
hobbyists database. 
CELLRATOR - Enter the caves 

RAINBOW CHASER 

Rainbows means points in this 

unusual game. 

HIDDEN GRAPHICS - Utilise 

those graphic screens. 

FORTRESS - Save Ihe world! 

Yet again. 

DISK HUNTER - Keep tabs on 

your disk library. 

SUPERFILE - One more for the 

record keepers. 



VOL 3No.1 NOV '89 
BASIC EXTENSION - Windows 
and Icons ihe easy way. 
BRAID - Vertical scrolling 
shoot'em up, 

DISKONOMISER - Prudent 
disk block saving. 
HELP - Design your own 
information help screens. 
ORSITAL - An arcade style 
game with a difference. 
PROCRAM COMPARE - Basic 
program development has 

RASTER ROUTINES - A lew 

colourful demos. 

SPRITE EDITOR 1 - A no 

niniM.'riit' basic iprite editor. 
WABBIT - Help the rabbit 
collect his carrots. 



FROGS IN SPACE - Leap to safety 

across the space lanes, 

BLACKJACK - Don't loose your 

shirt. 

LORD OF DARKNESS - Defeat 

the evil lord in true adventure 

style. 

MARGO - Fly around and collect 

jewels and fuel. 

(ETRACE 2000 - Have you got 

what it takes to be best? 

ULTIMATE FONT EDITOR 

Create your own screens, layouts 

and characters. 

SELECTIVE COLOUR RESTORER 

- Design your own system start 

up colours. 

6510+ UNASSEMBLER - 

Transform 65 1 0+ M/C inln source 

with labels. 

TRIVIA CHALLENGE - The first 

of 3 files for this superb game. 



VOL 3 No.4 FEB '90 
COLOUR PICTURE PRINT 
Download your favourite 

BASE-ED2 - An update to our 

popular rl, it, i l.h.i so system. 

1ST MILLION - Play the market 

in this strategy game. 

FM-DOS - Enhance your drives 

operating system. 

CEOS FONTS - A further 4 

fonts tor Geos users. 

HASHING IT - Relative file 

programming made easy. 

MULTI-SPRITE - Make full use 

of up to 24 sprites. 

DIRECTORIES EXPLAINED 

Find your way round the 

directory jungle. 

TRIVIA CHALLENGE - The 2nd 



VOL 3 No.5 MAR '90 

PLAGUE - Become your 

planets Guardian and 

Defender. 

SURROUND - Reversi on Ihe 

C64 

GEOS FONTS -The las! of 12 

new Geos fonts. 

SCREEN SLIDE - Create your 

JOYSTICK TESTER - Put your 
slickls) through the mill. 
COLOUR MATCHER 

Mastermind lor the younger 

players. 

SCREEN MANIPULATOR - Full 



recordings, 

TRIVIA CHALLENGE - The .3rd 

and final pari of Ihe game. 



Back issues of CDU are available at £3.25 per issue, which includes postage and packing. 

All orders should be sent to:- Select Subscriptions Ltd, 5, River Park Estate, Berkhamsted, Herts, HP4 

1 HL. Please allow 28 days for delivery. 
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Adventure Helpline 

The microsopi? swoops i 



Adventure Writing 

Help with software development 



Tech no- Info 

Can you help me? No, but I know a 



Exploring the 1541 

Some in depth help for 1541 i 




Banking 1 28 

A simple way of keeping your money straight 

Disk Driver V4 

A simple disk utility 



Autobout 1 28 

C1 28 users gel easy access to the C 

Reading between the Lines 

Build your own adventure parser 

I.D.O.S 

A comprehensive drive utility 

Price Calculator 

Keep tabs on inflation 



Screen Designer/Compiler 

Impressive screen layouts for all 



Landscape Routine 

Beginners guide to scrolling backdrops 



Sample Kit 64 

More sampling for all y 
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INSTRUCTIONS 



EDITORS COMMENT 



Thi 



the blank 



tting 

say for this months editorial spot, 
when I was suddenly brought bark 
to reality by the noxious sounds oi 
the telephone bell. To say the caller 
was somewhat irate would be an 
understatement. "What the heck is 
happening with my submission" he 
wished to know. "Don't you know its 

accepted lor publication, when is it 
inning l i.i ,ippear in print". The simple 
answer that I gave him, and this goes 
for EVERYONE else that Is waiting to 
see their masterpieces appear in print 
is this; I cannot give ANYONE a 
definite date for publication. Please 
try to remember that we only publish 
approximately ten programs each 
issue. We also TRY not to repeat 
programs too often. That is to say, if 
we publish a SPRITE EDITOR, we try 
not to publish another one too soon. 
Therefore, trying to select original 
programs gets harder and harder all 
the time. On top of this, don't forget 
that we are accepting programs each 
and every week, therefore the library 
oi accepted programs is growing at a 
greater rate than the publication rate. 
All I can say is this: PLEASE be 



DISK INSTRUCTIONS 

Although we do everything possible 
to ensure that CDU is compatible 
with all C64 and CI 28 computers, 
one point we must make clear is this. 

The use of 'Fast Loaders', Cartridges' 
or alternative operating system; such 
as 'Dolphin DOS', may not 
guarantee that your disk will function 
properly. If you experience problems 
and you have one of the above, then 
we suggest you liisabie them and use 
the computer under normal, standard 
conditions. Getting the programs up 
and running should not present you 
with any difficulties, simply put your 
disk in the drive and enter the 
command. 

LOAD"MENU\B,1 

Once the disk menu has loaded you 
will be able to start any of the 

programs simply be selecting the 
desired one from the list. It is 
possible (or some programs to alter 
the computers memory so that you 
will not be able to LOAD programs 
from the menu correctly until you 



:t the 



ichine. We therefore 









had 



program/article accepted 
publication. We WILL publish it 
eventually, it's just a matter of lime. 
(If it is of any consolation to you all. 
my own programs, DISK TOOLBOX 
and LIBERTE took nearly 15 months 
before they appeared in print. ..and 
I'm the Editor..!!). 

Anyway folks, once again I thank 
you all for your lantaslic support and 
letters of gratitude this past month or 
so. It really is heartwarming to know 
that the hard work you put into 
producing a good quality (which it 
is) magazine, is so richly received by 
it's readers. Mow on with the show.... 



suggest that you turn your compute 

off and then on again, belore loading 
each program. 

HOW TO COPY CDU FILES 

You are welcome to make as many of 
your own copies of CDU programs 

as you want, as long as you do not 
pass them on to other people, or 
worse, sell them for profit. For 
people who want ;o make legitimate 
copies, we have provided a very 
simple machine- code file copier. To 
use it, simply select the item FILE 
COPIER from the main menu. 
Instructions arc presented on screen. 

DISK FAILURE 

If for any reason the disk with your 



copy of CDU will not work on your 
system then please carefully re-read 
rhe. operating instructions in the 

magazine. If you still experience 
problems then: 

1 . If you are a subscriber, return it to: 
Select Subscriptions Ltd 

5, River Park Estate 

Berkhamsted 

Herts 

HP4 1HL 

Telephone; 0442-876661 

2. If you bought it from a 
newsagents, 

then return it to; 
CDU Replacements 
Interceptor Croup 
Mercury House 
Calleva Park 
Aldermaston 
Berkshire RC7 4QW 
Telephone; 0734-B17421 

Within eight weeks of publication 
date disks are replaced free. 

After eight weeks a replacement 
disk can be supplied from Interceptor 
Group for a service charge of £1.00. 
Return the faulty disk with a cheque 
or postal order made out to 
INTERCEPTOR CROUP and clearly 
state the issue of CDU thai you 
require. No documentation will be 

Please use appropriate packaging 
cardboard stiffener al least, when 
returning disk. Do not send back 
your magazine, only the disk please. 

NOTE: Do not send your disks back 
to the above address if its a program 
that does not appear to work. Only if 
the DISK is faulty. Program faults 
should be sent to; BUC FINDERS, 
CDU, Alphavite Publications Ltd, Unit 
20, Potters Lane, Kiln Farm, Milton 
Keynes, MK1 1 3HF. Thank you. 



ON THE 




n 




A very simple, yet effective program for keeping a track of your bank account. 
RICHARD TANNER DIRECT DEBITS 



The following program Is for CI 28 
users with 80 column capabilities on 
their monitors. It will NOT work in 40 
column mode. Secondly, before using 
(he program Banking 128', ensure you 
copy the file onlo a blank disk. This is 
because the program creates it's own 
tiles and will need lots of disk space. 
Last, but not least, the program on the 
disk is a Basic version so that you can 
tailor il to meet your own needs. 

THE NITTY GRITTY 

When the program is loaded and run 
for the first lime, you will be told there 
is no data file on your disk. This is 
correct because you have no files at 
present. From the displayed menu, 
select number 1 , which creates a blank 
datafile. The program asks for a date, 
this must he valid and of the right 
format (DD/MM/VY). Don't worry, 
anything wrong will be rejected. Once 
the (ij-il.irile has been created, |iress any- 
key and the program will try again to 
load the datafile. Now you will get 
another message, thai there is no direel 
debit file. This again is correct, because 
you do nol need to have one. This will 
be explained laler. You now have la 
enter today's date, same format as 
before. The main menu is ihen 
displayed, 

MAIN MENU DISPLAY 

OPTS EXPLANATION 
1 Firstly this sorts the records, 

Ihen saves them to disk. 



Inputs credits into the system, 
i.e.; money into the account 

(the explanation field is totally 
free text, but you must put 
something in). 

Inputs debits into the system. 
i.e.; money out of the account. 
(explanation field is as above, 
see option fl for reason). 
Displays the current state of 
the account (total money). 
You can alter or delete a 
record, but you must have the 
date of the record handy. 



Prinl 



) the sr 



or printer slarting from '. 
Sorts the records into date 

order, you should hardly ever 
need lo use this because every 

ir files, this is 



done! 






Lists all your expenses {Debits), 
type in the text to search on 
(from the explanation fields on 
Credit and Debit) and all the 
m.ili fiint'. expenses are 
displayed and totaled. This is 
very handy for adding up all 
your cheques etc., don't forget 
that you need to give a good 
explanation in 2+3. 
Takes you to the Direct Debit 
Editing menu, see below. 



This is where you enter your direct 
debits to be automatically taken out 
when loading the program again. You 
supply the starting dale of the Direct 
Debit, the text which when added into 
your account records, comes out in the 
explanation field, and fhe amount. 

This menu is mainly the same as 
the other one, but don't forget ihis is 
another file and you must save it with 
option 4, if you don't then when you 
load ihe program back in, all will be 
lost. 

Once you have set up your Direel 
Debits, save them, and now ihe 
program is all set up for your first 
automatic withdrawal. Next time you 
load the program, all you will need to 
do is give today's date, ihis must be 
correct else the program will take out 
ihe direct debils missing from your 
files. 

The Direct Debits check the month 
before today's date, ihis month and 
next month. If any of these files are 
missing it automatically adds them in. 
The best thing to do with the program 
is lo experiment. If you do not have 
any direct debits, don't worry, the 
program will just skip the automatic 
direct debit part and put you straight 
into ihe main menu. 

If you have any queries regarding 
this program, I will be pleased to help, 
lust write in to me c/o the magazine. I 
hope that this program tidies up vow 
kink di'tnils for you. 



[<»r 



THE DISK 







DISK DRIVER V4 



Overcome the difficulties of talking to your drive with this 

The Commodore 64's Basic, as .ill PAUL CClCHRAtiiF 

programmers know, is sadly lacking ™ UL *'«'™W«C 

many features. An ideal example of 



latest drive utility program. 



Wher 
vith 'ne> 






me that 



take the 



>rkload 



the 



programmer when they wa 
the disk drive while they art 
their masterpieces. 

Some of you will be wing "But I 
have already got these features in my 
extended Basic", granted. Most 
extensions however, provide these 
features by adding extra commands. 
Disk Driver V4 goes one better and 
provides all these pilrti utilities ,il ihe 
press of a Function key. The format 
for which is shown here: 

F1 - Display directory 
F2 - Validate disk 
F3 - Load a file 



Most of the facilities offered are self 
ng explanatory, so I will describe how to 
respond to the computer when 
if I prompted. 

When the message 'sure (y/n)' 
appears, press the "Y" key if you are 
sure it's what you intend, otherwise 
press the *N" key. When a list of the 
files on the disk are shown, the 
computer expects you to select the 
file which you want lo carry out the 
operation on. The highlighted cursor 
can be moved up through the files by 
pressing the 'CTRL' key, and can be 
moved down through the files by 
pressing the 'COMMODORE' key. 
Once the cursor is over the file that 
you wish to select, press the space 



expects you tc 
you wish to call the file. The RUN- 
STOP key can be used to exit this 

If you select Ihe same function 
key twice without pressing any other 
key, the key will not register. This is 
to prevent the key being hit twice 
quickly which could cause the 
computer to crash. To re-enable the 
function key press any other key. 

PROGRAM INFORMATION 

The 'Disk Driver V4' machine code 
resides in the area of memory from 
$C90Q-$CF0n. The program works 
by altering the 'KEYLOC vector at 
S028F to point to the Disk Driver 
routine. As 'KEYLOC is a kernal 
vector, if is reset upon using RUN- 
STOP/RESTORE. To restart the 
program enter SYSS1456. 



■it xkx SCRATCH 


FILE 


«*** 


"FC.MC" 




"BOOT MC" 


"BOOT-BASIC" 




"BASIC BANKING" 


"WINDOW DEMO" 




"WINDOWS" 


"PROG 1" 




"PROG 2" 


"PROG 3" 




"LAND CODE" 


"LAND DATA" 




"PRICE CALCULATOR" 


"SCREEN DESIGNER" 


"SCAD" 


"COMPILER 52000" 


"COMPILER CODE" 


"DRIUER 04. CODE" 


"THE BOSS" 


"DEMO" 




"IDOS" 


"SAUER" 




"SAMPLEKIT" 


"SAMPLEPLAVER 


, ASM" 


"MISC .SAM" 


"MISC. TUN" 




"MISC .SPL" 


"PIC2" 




"PIC3" 


"OW-DECOM. MC" 




"AW-DECOM.SRC" 


"TECHNO INFO" 




"MAIN" 


"ALL CODE" 




"rjPIC LANDSCAPE " 


SELECT FILE WITH: 




CTRL - UP COMM - 


DOWN SPACE - SELECT 






AUTOBOOT 



C1 28 users can now get your CDU disks up and running with this autoboot program. 

KARL HOPE 



OBOO BVT $43,$42,$4D 


'com' 


OB03 6VT S00,$00,$00 


boot sector control codes 


OBUfi BYT SD0,$4D,$45 




OB09 BYT $4e,$55,$00 


'menu' 


0B0C BYT $00 




OBOD SEi 




OBOE LDX #$(10 


copy program to autostart 


OB10LDA$OB1C,X 


$8000 from $0B1C to end 


0B1 3 STA $8000,X 




QB16DEX 




OB17 BNE$0B10 




0B19JMP $FF4D 


CI 28 vector -C064 


0B1C BYT $09,$80,$04 




0B1F BYT$80,$C3,$C2 




0B22 BYT $CD,$38,$30 


'CBM80' 


0B25 |SR $FDA3 


init I/O 


0B28JSR$FD50 


init system constraints 


0B2BJSR$FD15 


reset KERNAL 


0B2EISRSFF5B 


init screen timers etc 


0B31 CLI 




0B32 JSR$E453 


init vectors 


OB35J5R5E3BF 


init Basic 


iJBJBJSR SE422 


check memoiy/title/NEW Mc 


0B3B LDA#$05 


tile number 


0B3D LDX #$0B 


device 


0B3FLDY#$Ol 


M.-t und-iry address 


0B41 JSR $FFBA 


kernal SETLFS 


OB44LDA#$04 


filename length 


0B46 LDX #$3C 


name address do] 


0B48 LDV #$B0 


fume address (hi) 


0B4A |SR $FFBD 


kernal SETNAM 


0B4D LDA #$00 


$00= load 


0BS2 LDX #$FF 


reset itiick pointer 


0B54 TXS 




0655 JMP $£386 


exit via to,, online 



You will all be aware that the C128 
has an autoboot feature for disk 
users, this useful tool could be a 
great time saver for us CI 28 users 
that purchase CDU each month. We 
simply have to insert the disk and 



rt the c 






is the 



For your convenience, there are 
two copies of the program on this 
months disk. One being the machine 
code (which boots to $0B00 ■ CI 28), 
ihe other being a Basic listing of the 
disassembly. 

For those thai may be interested, 
here is a copy of the listing. 



,.■ ,:-,.i ■ 



C64 






whilst I have sel it to #$FF. The 
reason for this is that the Cu4 holds 
return addresses after a JSR on the 
stack. My program was loading the 
files from the menu and then loading 
the menu again straight away. The 
extra tour bytes usually on Ihe stack 
will have been the two addresses at 
the beginning of the autostart 
program, which naturally point to my 
program, this being the reason why it 
constantly reran. 



READING BETWEEN THE LINES 



Any adventurerer will tell you that an adventure is only as good as the parser. Now you can 
develop your own with relative ease. 






rolfi ,-, 



mpute 



'Chop down the 
the axe', then had a reply like 'where 
did you learn English?'. The "Parser" 
utility presented here may tome to 

This parser is intended (or use as 
a front end for adventure programs, 
but can be used anywhere that you 



program must also be in machine 
language. 

THE SYNTAX 

The first thins that must be done 
when writing a parser is, of course, 
to define the syntax of itie langtiagti. 
The basic command structure for this 
parser is (verb) (verb supplement! 
(objectl! (verb supplement) 
(preposition) (objecl2), where an 
object is defined as (owner) 
(adjective) (noun). EG: Pick up the 
leather saddle under the big tree. At 
the end of a command, there may be 
a full stop, comma, quote or joiner 
which may seperate another 
command. 

Note that, although the verb 
supplemenl can appear in one of two 
places, it can only be in one place in 

'Pick up the axe up'! Also, an object 
may t* tppl.iced by a pronoun. The 
pronoun will be taken as the last 
owner/adjeftive/noun combination 

i' speech is involved, the 
beginning cil a command will be (say 
verb) (say preposition) (objectj) ("). 
Quotation marks are required around 
the speech so the parser can tell 
when; i ends when there is more 

sentence. II In the sentence, Say to 



GORDON MOYES 

the tall Elf go north and get the axe; 
who is going to gel the axe, you or 
the Elf? Things become much clearer 
if you write; Say to the tall Elf "go 
nnrlh and gel the axe" 

Many outputs are therefore 
required to analyse every word. 
Table 1 lists all of the outputs from a 
(.ijiYibiruHion routine, which greatly 
reduce the number of variables that 
need to be used by the main 
program. 

ACTION/OBJECT 

COMBINATION 

The action and object combinations 
are both called by 5YS49161. Their 
purpose is to reduce the number of 
variables ih.il llic main program must 
work with. The action combination 
combines the verb and the verb 
supplement into one variable, the 
action. It works like this; If the verb 
supplement is equal to zero (not 



present) ihe 



n equals the verb. 1 



routine checks through the action list 
to see if it can match both the verb 

does not succeed then it outputs a 
255. 

The object combination routine is 
similar to the action combination 
routine, except that it combines an 



ited number of adjectives may 
appear in the object lists, instead of 
just one. The owner is 

THE MAIN PROGRAM 

Lines 7000-7070 define the variables 
in the machine code program. Nole 
that FNP(X) is the same as 
PEEM50040 + X) throughout the 
program. 

Lines 7080-7130 input a 
command string from the user and 
puts it into the parser input buffer 
along wilh its length. 



FNP(X) 


output 





Verb 1 Verb position 


2 


Verb 5up 3 Sup position 


4,5,6 


Owner 1,2,3 7,8,9 Owner posi lion 


10,11,12 


Adj 1,2,3 13,14,15 Adj position 1,2,3 


16,17,11 


Noun 1,2,3 19,20,21 Noun position 1,2,3 


22 


Preposition 23 Preposition position 


27 


Say verb 28 Say verb position 


29 


Say prep 30 Say prep position 


24 


Error (see table 2) 


25 


More;0if end of line reached. 1 if more 


26 


Say More; 1 if still in quotes and more =1 


32 


Object 1 


33 


Object 2 


34 


Object 3 


PA 


Position in wotd buffer parser is up to 


BF 


Start of buffer 


OU 


Start of output variables 




TABLE 1 - Parser Variables 



There is no noun wilh object'1 

2 There is no noun wilh objecl 2 

3 There is no noun wilh object 3 
Some sentence is left over after 

parse is done 

5 No first quote in say command 

6 Word is not recognised at all 



TABLE 2 ■ Errors 



:onfusi 



any 
veen a verb 
supplement and a preposition. If 
there is no preposition, a second 
object and a supplement (which can 
also be a preposition i.e. on/to) then 
they are swapped before line 7170 
calls the combination routines. 

Lines 7180-7500 print the parser 
outputs. 

Lines 7300-7320 print out the 
word that the parser got stuck at if 

unrecognised objects and actions do 
not show up at this stage. 

Lines 7330-7410 check through 
the three objects to see if they ate all 
recognised or not present. If they are 
unrecognised, the program prints oul 
the unrecognised section by using 
the print on list routine. 

Lines 7420-7490 check to see if 
s recognised. If it is not 



table 3), POKE PA+1 with the words 
position In that list and SY549158. 

command in lines 7370-7400 and 
7450-7460 to let the user know of 
unrecognised objects and 
commands. 

PRINT FROM BUFFER 

This command is used to print out 
unrecognised words. Il is called by 
SYS49155 when PA contains the 
starting position of the word in the 
buffer. Note thai when an error 
occurs, PA will contain the starting 
position of the word that the parser 
got stuck at The main program uses 
this command in line 7310 every 
time an error occurs lo lei the user 
know where it became stuck. The 
error number will indicate why the 
parser became stuck tsee table 1 ). 

THE WORD READER 

The purpose of the word reader is to 
read in the computers vocabulary. 
You can change this around as much 
as you like to suit your own 
adventure I -■■ starting address < ,m 
be chanf.fn lo suit yo.. r needs, bul 
remember to protect it from Basic 
Every word stored s followed by .i 
number . .- the word number 

thai is returned by the parser and Is 
used lo grci.,;i wu'uj that mean the 
same thing. The word position 



number that is returned distinguishes 
between words that mean the same 
thing so that they can be printed 
from the dala lists. 

Every item of action data must 
lake the form (action) (verb) (verb 
supplement), with a zero byle 
marking the end of the list. The first 
entry of 1,200,1 translates to: If verb 
is 200 (pick) and supplement is 1 
(up) then the output will be 1 (the 
same as get or take). 

Items on the object list are stored 
as (objecl) (noun) iadjl) (adj2) .... 
(adj n) (255), again with a zero byte 
marking the end of the list. Note you 
can have as many adjectives as you 
require in the list. The first entry of 
5,5,5,6,255 therefore means that if 
the noun is 5 (horse) and the 
adjective is either 5 (skinny) or b 
(small/short) then ihe output will be a 
5. Note thai the same output is 

Verbs 

1 Verb Supplements 

2 Nouns 
1 *dj ues 

4 Owner-. 

5 Pronouns 

6 ]•■■<■- 

7 Prepositions 
'i Sa) i, •!:. 

TABLt 3 - List Numbers 



thei 




printed out with the pi 
routine. 

Lines 7510-7550 wait until the 
space bar is pushed before printing 
oul another list, if thi 
than one command 
was just entered. 

PRINT FROM LIST 

When the 

unrecognised by the main program, 
it would be handy to be able lo tell 
the user this. To use this command, 
POKE PA with the list number (see 
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OBJECTS 




ACTIONS 


SAV VERBS 


1 


North 




1 


( ii j l/i,ike/pick up 


1 Say/tell 








3 


Discard/leave/pul down/ 


2 Shout/yell 










throw away 






East 




3 


Kick/hit/kill 


JOINERS 






; small/skinny 






1 And/then 


6 


Elf 


: short/fat 


5 


Go/move/ride 






Elf 


; tall/blue 


6 


Climb/ascend/go up/climb up 


OWNERS 


8 


Axe 


; pointy/wood 


7 


Descend/go down/climb down 


1 A/an/lhe/my 




Armour 


; rusty/metal 


8 


Chop down 






Tree 


; big/wooden 


9 


Dig out 


PRONOUNS 


11 


Bars 


; large/melaf 


10 


Wear 


1 ll/them/him/her 






; leather 


11 






13 


Goblin 


; big/fat/a range 


12 


Close 


PREPOSITIONS 




Door 






Pul 




15 


Door 


; south 


200 


Pick 


2 With/using 




Door 


; west 


201 


chop 


3 Near/around 








202 






200 


Elf 










201 


Door 




TABLE 4 - Parser Vocabulary 


6 TO 






adjec 



is supplied. The code presented hi 

■ check lhat front end for an adventure program, program 

only valid adjectives are used, but it It is up to you to subslitute the Writing' 

' o be used to seperate between sample main program 



m cJiltc-rc- 



n Ihi- prnjimi 



Mill v 









pm-uin 



Vou should be able to put your i 
gained knowledge ro some good 
in the very near fu!ure....PAE! 
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ON THE DISK 




Getting to grips with Drive operations is easier with 
Interactive Disk Operating System. 



■■ CLOSE! "> 



If you are new to a Commodore disk 
drive you are problably ihinking 

"where's the Commands?" or "How 
do I delete a file?". Well believe it or 

not, the Com dick] on.' disk drives do 
have commands but rhey are VERY 
difficult 10 get used to. To delete a 
file from a disk you have to type in 
the following; 

OPEN1 5,8,1 5,"S0:l"ilei 



To delete a file on a BBC machine 
you only have to type; 

•DELETE filename 

Now wh <h is the easiest to 
it'inc nbcr? No competition, the BBC 
command system beate Commodores 
hands down Yet the Commodore 
disk 'If ves .ire probably the most 
ddv.inc 1 1) .uid versatile disk drive 
systems available for an 8-bit 



A BIT OF HISTORY 

So why are the Commodore disk 
drives the most difficult to use? It all 
lies with a decision made by 
Commodore a long lime ago when 
the VIC 20 was screaming for i disk 

drivt . As you will p'uuably know, 
the VIC 70. only ,. | .v .... i-,. 
was no way thai „ whole ri.sk 
operating system <ou C be crammi rl 
into i .- . ■ H . ■ i ,■ ; omrnoriore 
in I ii' ■ ii' a sdom therefore 

dec ded lo ;ju' the il -k operai ne 
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commands because I have devised a 
program which handle; all those 
commands through a BBC-like 
interpreter. 

THE INTERACTIVE DISK 
OPERATING SYSTEM 
(IDOS) 

!DOS is an Interactive program lor 
use with the C64 + disk drive, which 
allows the user to manipulate their 
disk with ease. Commands range 
from the simple LOADing and 
SAVing of program files to lucking 
files against erasure. Other 
commands allow the disassembling 
of machine code programs directly 
off disk without first loading them 
n memory. 



All 



lands 



altera 



j be rt 



3 ('■■.■ 



VIC's ROMs and thus saving a lot of 
memory, il also meant that the disk 
drive could be doing something 
while the compuler did something 
else. It also meant, (and this has only- 
been utilised recently), thai the disk 
drive acted like a compuler in itself 
and two could be connected 
together without a computer; once 
they had been programmed; and talk 
to each other. They could for 
example, copy disks from one drive 
to the other while the computer did 
something totally different. 

This was impossible on any other 
disk drive system. One problem was 
that the disk drive system was serial 
which meant that the whole system 
was very slow. Unfortunately, or 
lorliiniilely depending on bow you 
look al it, the VIC-20 disk drive had 
to be compatible with the all-new, 

machine, Ihe Commodore 64. So the 



through a very Basic-like interpreter 
which allows abbreviations by the 
use of a full stop (.). This also allows 
ALL commands to be accessed from 
outside the interpreter i.e. from Basic 
programs or direct mode. IDOS does 



ROM 



system was retained. And not much 
has i hanged since then. Anyway, 
oji k to the reason for this article, to 
gel ihe drive system communication 
■i il gh the serial cable has lo be 
done manually, hence the 
complicated commands. Well, now 



except LOADing, so once the 
program has be LOADed off disk it is 
ready for use, no SYS calls to 
remember! 

IDOS interacts with the 
operating syslem by use of a vector 
system which the C64 uses to lest if 

Locations $Ft004 to $8009 usually 
hold garbage, but if it contains $C3. 
$C2, $CD, $38, $30 CCBM80") 
then ihe machine gives control over 
to the vector held in $H000 and 
$6001. IDOS simulates this so on 
pressing RUN/STOP and RESTORE 
the machine jumps lo the address 
held in $8002 and $8003. Usually 
this would stop any warm starts but 
a bug (???) in the operating system 
also does this if only the RESTORE 
butlon is pressed, so IDOS is run by 
pressing RESTORE. It RUN/STOP is 
also pressed then a normal warm 
start occurs, very useful for 
breaking out of IDOS or any other 
program. . 

THE COMMANDS 

The commands are shown in BOLD; 
< and > denote single par, 



required NOT enclosed by quotes. 
Nole: any names thai need to 
contain spaces MUST use shifted 
spaces. (IDOS automatically changes 
them to normal spaces!, as IDOS 
uses spaces as parameter separates. 
Any paramelers that are enclosed by 
I and I ate optional and can be 
missed out. All <addr>'s are in 
HEXadecimal, all other numbers are 
in DECimal. Filenames may contain 
wildcards (• and I) for selective 
operations. If no filename is given, 
'"' is used instead. 

LOAD <(i)ename> )<addr>| 

This loads a program under the 
filename <filename> from the disk 
into memory at address <addr>, if no 
address is given then the default is 

the address specified by the program 
header (i.e. where ii was saved imm. 
Minimum abbreviation: L 



NOTE: the LOAD/SAVE operations 
do not use the normal ROM routines 
for LOADing.SAVEing, instead IDOS 
uses it's own. By using the ROM 
routines OPEN.CHKIN.CHKOUT. 
CHROUT.CHRIN it does read/write 
operations manually. The advantage 
of this is lhat the number of blocks i 
loaded can be shown, so you can 
immediately see how much of the 
program has loaded. It also means 
that IDOS has control all the lime so 
the LOADing and SAVEIng can be 
stopped by pressing the RUN/STOP 
key. Even better, it allows relocation 
of LOADing and SAVEing data. 

VERIFY <filename> {<addr>| 



problem is. (Usually with Machine 
Code programs, the program alters 
ilself and so the version on the disk 
will be slightly different from the 

VERIFY would give VERIFY ERROR 
and immediately the uset is 
convinved that the version on disk is 
corrupt). 

Example: 

>VERIFYHIRES.CODE 

Minimum abbreviation VE 

SAVE <filename> |L) |<addr>] 
|<addr>] {<addt>| 

This is probably the most useful 
command, it allows a block of 

memory to be saved much like the 
BASIC SAVE command but a number 
of useful additions have been made. 
Firstly [he command automafically 
uses 'Save & Replace', lArrnh! I hear 
some of you cry, there has been a lot 
of rumours in the corridors of 
Commodore about the safety of this 
command on the 1 541 , hut there has 
been just as many tumours about 
ways to beat this bug. One of the 
safest is using @0: inslead of just @:. 
Anyway, I own an Oceanic OC-llfj 
which does nol have this 
bug!... I Editors extra note: I have used 
@0: since 1904 and have NEVER had 
a problem of any description.. ..EdII), 
which replaces the current version 
on disk with the new version. The 
'Save & Replace' can he switched off 
by Ihe REPLACEOFF command (see 



start address, ii il is not given or '0' is 
used then the start of current Basic 
program is used. (i.e. held in 
locations Ai and 44). 

The second |<addr>l is the 
optional end address, it it is not given 
ot '0' is used then the end of the 
current Basic program is used (i.e. 
held in locations 45 and 46). 

The third l<addr>| is the optional 



then n 



. This 



The 



■t kaddr>| is the oplioi 



allows a block of n 

saved from one area in memory but 

memory. Very useful when saving 
sprite or character data. 

The |L| is a very quick and useful 
way to protect a file against 
accidental erasure, it locks the saved 
file so it cannot be erased (unless you 
unlock it of coutse). 

fianipfes: 

SAVE IDOSLB000A000 

Will save IDOS onto disk and lock it 

(From SatlDO to SACltM where IDOS 

exists). 

.s.AV[ PROGRAM 



Minimum abbreviation: S 

EXEC <filename> (<addr>| (<addr>|, 
RUN <filename> f<addr>| |<addr>| 
These commands load and execute a 
program off the disk. It uses the same 
patameters as the LOAD, The first 
<addr> is the load address and the 
second is the execution address. II" no 
address is stipulated the program is 



This 



j Ihe 



e the si 



parameters a; 

LOAD though, ihe progra 

actually entered into memo 

memory. At the end of the \ 
the number of mismatched t 
shown, unlike the ROM V 
routine which just shows whe 

routine gives actual numbers 



FILENAMES E<flDDR>3 

;iME> E<ADDR>] 
FILENAME? t L J E-CADDRM E<(%0 

> E<HDDR>] KflDDRM 
E<ftDDR>] E<HDDR>] 

> <FILEHftME>. . . 3 

> <FI1_ENfiME>. . . ] 

> E<flDDR>] 

> E-CLINENUMBERM 

> tCADDR>] 

:> <OLDH«ME> 
COLDNflMO E< ODD KAMI 
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Example: 

>COPV HIRES-CODE! HIRES- 

Minimum abbreviation: CO 

COMPACT, VALIDATE 

These commands validate ihe i 
disk. Equivalenl lo VO. 



Example: 

>EXEC MC-GAME COOO 

Minimum abbreviations: E for EXEC, 

R for RUN 

COMMAND <command> 

This outputs a normal D05-type 
command such as SO:filename 
Minimum abbreviation: C 

CAT |<filename>] |<filenaine>...|, 
DIR {<filename>} |<filename>...l 
These commands display the 
Directory of the current disk, the 
filenames are optional and allow fur 
selective cataloging. 



D for DIR 

PRINT <filename>, DUMP 
<filename> (<addr>|, TYPE 
<filename>, UST <fjlename> 

l<linemimber>|, DISS <filename> 
l<addr>| 

All these commands displ.iy file dau 
from the disk to the screen but in 
different ways. DUMP displays a 
Hex and ASCII dump of a file from 
<addr> onwards. If no address is 
given then the start of (he file is used. 
PRINT prints out a file onto the 
screen, it does not prim any control 
characters at all, TYPE is like PRINT 
but it prints out all characters 
including control characters. LIST 



linenumber is given then il is listed 
from the start. DISS disassembles a 
machine code program from the disk 



the 



from 



:addn> 



onwards. If no address ifgiven then 
the start address is used. All these 
commands can be used on PRC, 
USR and SEQ files. The output of a 
file lo the screen ran be paused by 
pressing CTRL, SHIFT, 5HIFT LOCK 
or the COMMODORE KEY, or 
stopped by pressing the RUN/STOP 

>DISS HIRES-CODE 
Minimum abbreviations; DU for 
DUMP, LI for LIST, Dl for DISS, T for 
TYPE, P for PRINT 

SIZE <filename> 

This shows the size of a file in blocks 
and bytes, ii also shows where the 
program would be situated in 



Minimum abbrevialiom SI 
RENAME <newname> <oldnamu> 
<nldname> tt 
Example: 



>REN. 

c5de 



vIE HIRESCODE HIRE5- 
i abbreviation: RE 



SCRATCH <frlename> 
l<filename...>], DELETE <filename> 

l<filename>...[, ERASE <filename> 
l<filename>...] 



hi-, 



's from the disk. 



Example: 

> DELETE HIRES-CODE I 

Minimum abbreviations: SC for 

SCRATCH, DE for DELETE. ER for 

ERASE 

DISKNAME <dlskname> 



Example: 

>DISKNAME BA5IC PROGRAMS 

Minimum abbreviation: DISK 

NEW <diskname> {<Fd>}, FORMAT 
<diskname> |<id>| 

These commands format the current 
disk with the name <diskname> and 
ID <id>. WARNING: There is no 



Example: 

TORMAT NEWDISK ID 

i abbreviations: N for NEW. 
r FORMAT 
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DERR, ERROR 

These commands read the 
channel and displays It. 



DERR. ERR for ERROR 

PROTECT <fi1ename>, LOCK <filename> 

These two commands luck the given 
file against erasure. Equivalent to the 
Lin the SAVE command. 

Example: 

>LOCK HIRES-CODE 

Minimum abbreviations: PRO for 

PROTECT, LOC for LOCK 

UNPROTECT <ftlename>, UNLOCK 

<filename> 

These commands are the reverse of 

the above, i.e. they allow for the 

deletion of the given <filename>. 



UNLOCK, U for UNPROTECT 

NOTE: A locked file has a '<• after 

the file type in the directory. 
E.G. 33 "IDOS" PRGc 

RECOVER <filename>, UNSPLAT 
<filename> 

These commands restore a tile which 
has not been properly closed (i.e. has 
an '*' before the file type). The file 
can now be opened and read from so 
restoring it 

Example: 

>RECOVER FILE 

Minimum abbreviations: REC for 

RECOVER, UNS for UNSPLAT 

ADDRESS <filename> (<addr>| 

This command allows you to change 
the LOAD address of any file to 
<addr>, if no address is given, then 
the start of Basic is used. This is 

equivalent to the third <arJdr> in the 
SAVE command. 

14 



Example: 




HEX |<dec number>] 




>ADDRESS SPRITEDATA 4000 




This simple commund 


converts a 


Minimum abbreviation: A 




number into a hex 
displays it. 


number 


DRIVE <drive> 








This changes the drive yo 


are 


Example: 




working on to <drive>. <drive> 




>HEX 57344 




be between and 3 or the program 


Minimum alibrcvi.itior 


H 


will respond with ERROR: ILLEGAL 






DRIVE. It does not alter the nu 


mber 


DEC {<hei numher>l 




of drive but the device nu 


nber 


This is the o( ipi isili ■ tit 


lie above 


which the program uses (see be 




ii changes a hex n 


mber int 










Example: 








>DRIVE 




Example: 




Minimum abbreviation DR 




>DECF1CA 








Minimum abhrr-viaiin 


DEC 


DEVICE <drive> <device> |<drive>[ 






{<device>...} 




CALL |<addr>} 





This alters the device number which 
the program uses for <drive> to 
<device>. The program uses 4 preset 
device numbers, one for each of the 
drives, this command alters 
presets. On loading they are set 
follows: 

DRIVE DEVICE 



fir ample: 
>CALL C000 
Minimum abbrevia 1 



i:CAL 



2 10 

3 11 
The command alters the pn 
device number for drive <drive> to 
device =:device>. This may not seem 
like a very useful command, but it 
can be. Imagine that you own all 4 
drives. One of which is a 1 541 , two 
are 1 581 's and the last is an Oceanic 
OC-118N. The 1541 must have a 
device number of fi because you 
cannot change it without opening up 
the disk drive, the other three do 
have device changers and so they are 
set to 9,10 Ithe two 1581's) and 11 
(he Oceanic. It is obvious that you 
would want one of the two 1581 's to 
be drive because they have a 
bigger capacity, the OC-118N would 
be drive 1, the other 1581 drive 2 
and the poor old 1541 would be 
drive 3 (because of it's slowness and 
bugs.:. Normally this setup would be 
impossible, but with IDOS it is 
possible. 

Example: 
>DEVICE0 8 1 9 

Min mum abbreviation: DEV 



RESET (<addr>) 

This does a system reset and sets the 
Basic start address to <adrir> Isee 
below). Equivalent to SVS6473B. 



u ,iljhri"i i.i 



1:RES 



BASIC (<addr>) 

This command sets the start of Basic 

to <adrir>, if no <addr> is given then 

the current Basic program will be 

NEWed. 



Mini 



abbre' 



COLOUR < border col> <screen 
col> <text col> 

This command sets the colours of the 
screen and the colour presets of 
IDOS. 

Example: 
>COLOUR6 15 6 
Minimum abbreviation: COL 
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ID05, normally il is set to a '>' bul this 
command allows you to change II, 
Using a backarrow inserts a carriage 
return in the string (CHR$(1 3)1, the text 
can be anything up to 40 characters in 
length. To get no prompt just type in 
PROMP and press RETURN. 

Example: 

>PROMP ENTER COMMAND> 
Minimum abbreviation: PROM 

ERRON, ERROF, TEXTON, TEXTOFF, 
READON, READOFF, REPLACEON, 

REPLACEOFF 

This set of commands are flag setters. 

ERRON and ERROFF control DOS error 

messages! output. When switched off, 

no 00 OK 00 OO's are outputted, but all 

others are (eg 30 SYNTAX ERROR 00 

00). 

TEXTON and TEXTOFF control the 
output of certain types of text, these are 
the LOADing and SAVEing 
(BLOCKS S— and ADDRESS $- 
$ ) and ALL DOS error messages. 

READON and READOFF control the 
reading of the first two characters in a 
file, in program files this refers to the 
LOAD address of the file. It is most 
useful in DUMPing a file as it allows 
you to see how long the file is (the first 
two numbers in the dump will be the 
LOAD address). 

REPLACEON and REPLACEOFF 
control the 'Save and Replace' 
command in the SAVE. When it is ON 
then the form @0:filename will l)e used, 
when il is OFF then the form Oifilename 
will be used. I included this because 
some people are worried about the 
safety of the replace command. 

Example: 
>ERROFF 

Minimum abbreviations: ERRON 
for ERRON, ERROF for ERROFF, TE 
for TEXTON, TEXTOF for TEXTOFF, 
REA for READON, READOF for 
READOFF, REP (or REPLACEON, 
KFPIACEOF for REPLACEOFF. 



Example: 
>QUIT 

Minimum abbreviai 
Q for QUIT 



commands with their syntax, useful if 
you have forgotten how to use a 
command. 



the; 



<ailable from Basic, 
To access any 



IDOS IN USE 

The program is accessed by pressing 
the RESTORE button only (either in 
program or direct mode) or by typing 
SYS32780. The screen colours will 
change to the preset colours (altered 
by the COLOUR command), there 
should be a greeting message and the 
disk error channel displayed [unless 
ERROFF or TEXTOFF has been 
executed). 

INTERACTIVE DISK OPERATING 

SYSTEM MK4.U 

BY RICHARD DAY ©1989 



EXIT, QUIT 

These commands exit you from 
IDOS to the READY prompt in Basic. 
This routine will break you out of the 
current program (whether it is Basic 
or Machine Cede). 



oo, OK.oo.no 

A prompt (usually '>', but altered by 
the PROMPT command) and a 
flashing cursor should appear. This 
means that IDOS is waiting for an 
input, so type in a command along 
with any parameters and press 
RETURN. 

If IDOS responds with; 

ERROR : COMMAND NOT 

RECOGNISED 

Then you have not typed in a 
known command. To exit IDOS type 
EXIT, QUIT or their abbreviations. To 
perform a normal warm start hold 
down the RUN/STOP and press the 
KrSrOKL" button. 



mode or program mode type; 

SYS32777,<command>. 
The command MUST be in a string 
(i.e. inside quotes), this allows the 
following:- 

SYS32777,"DELETE "+F1$+" "+F2S 
Some useful SYS calls are; 
SYS327?7,<command> Execute 

command 
SYS327B0 Enter IDOS 

SYS327B3 Enable 

IDOS 
SYS32786 Disable 

IDOS (same 
as KILL 
command) 

GENERAL POINTS 

IDOS reticles in the block of memory set 
aside for cartridges (I8O00-SAOO0), so it 
will not work with arty sort of oruiflge 
system installed. IDOS cannot be 
relocated at all, even if you were to 
change all the references in the 
program, the RESTORE entry system 
would not work. 

Now I have a slight confession to make, 
there is a bug in the program, but before 
ygU start worrying il can be easily over- 
written. Sometimes the UNLOCK/ 
UNPROTECT routine does not work. I 
do not know why, maybe my drive is 
playing up, but it is not permanent. If 
you do find this bus; appearing continue 
using the UNLOCK/UNPROTECT 
command and CATaloging until Ihe file 
is unlocked, believe me it will. 



AND FINALLY 

And finally, my advice to you is ti 
experiment, be careful with ilie disk voi 
use to begin with just incase yoi 
accidentally erase something you wanl 
Ihe jio only ,i few command;, whii I 
actually jlter Ihe disk most just read ol 
it. I have a copy of this program on ever 
one of my disks, not because I wrote thi 
prograjn, but because I find i 

■.!■'■ i.'. I : 111 I ii, ■.villi, -.i.i. I 
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L3 

Calculate the buying power of any given sum of money for any year this century with this 
handy utility. 



-,, pocket money or pension 
eally kepi up with the cost of 
If you employ someone to do 
;ardening, av housework, are 



IAN DALZIEL 






■ preposing an increase in 
subscriptions, it witl greatly increase 
your chances at the AGM if you can 
matter, even if you know just where prove the increase is actually less 
> get the figures. Have you any idea than prices generally over the period. 



salary in real terms? Are recen 
increases in your annua 
subscriptions to magazines, clubs eh 
really needed to keep up with prices 
Certainly, everyone knows thi 
current yearly increase in the Retai 
Price Index (RPI), but calculating 
a longer period is anothe 



much prio 
increased in the last 10 years? Well, 



>nder 



for 



Calculi 

questions about prit 
the 'real value' of money, not 
for the last 10 years but fo 
period this century. 
Perh; 



II your 
id 



When someone tells you how cheap 
an item was in say 1960, you will be 

actually cheaper in real terms. 

If for example, you have a son or 
daughter that has just started work at 
a salary of 5,000 pounds per year, 
they will be able to compare it with 
the salary of their parents when they 




n 1965 bul 
[ be able K 
•ith your n„„ 

politician you will be able to prove 
~-iything with statistics! 

The program is very user friendly, 
I you need to do is to enter the 
r lce you know and the year 
applicable, then simply enter the 
year you wish to know the price of, 
for any year this century. The 
information used to perform the 
calculations was carefully researched 




B.O.S.S. 
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value of x. The range is to 15. 



MARC BANGS brings to you 23 new commands with his 

Basic Operating System Supplement. Developed with the 

C1 28's own Assembler 



After 



lard-h 



interpreter, only being updated while 

irticles on Extending Basic is being processed. This results 

blished in Your in the clock stopping during an 

I decided to write my INPUT statement, or when no 

. These routines were command is being processed. The 

eloped using the built in clack will also stop if the command 

y CI 28. Because of OFF is given. The advantage of this is 

the way this extension has been that the interrupt is left unused, and 

coded, it is a simple: job to emend it can run some c 

with your own commands. Simply program, 
add your own commands at the end 
of the code and make the 
branches/jumps. 



CommuHoi' 



Aisi'mblti 



AT n,y - Changes the position of the 

cursor to x for row and y for column. 

EG: AT 12,15:PRINT"HI THERE" 

(Note the colon before the Print 

statement). 

ROM - Simply shows the Kernal 

release number of your machine 

POINTER on/off - Turns sprite either 



r off. , 



upt i: 



it up, 



. backgro 




OLD - Recovers a newer! pi-iiv;r,im 

OFF - Turns off the Basic extensior 

DISK - Defaults all I/O to disk, 
secondary address may be passed 
whilst in operation. 

TAPE - As above, but defaults to tape. 

NORM - Returns to standard. Primary 
and Secondary addresses can be 



CLKON - Turns on the Basic clock 
The clock shows the current value oi 
Til in the top right hand corner of the 
screen. The clock runs off the 



CLKOFF - Turns the clock off. 

HIRES - Turns on hi-resolution mode 

LORES - Cancels hires mode 

FILL - This changes the entire colour 
memory of the picture. The syntax is 
FILL x where x is a number in the 
range to 255. The high nybble of 
this number is the paint colour, the 
low nybble the canvas. EG: FILL1 will 
give Black paint on a White canvas. 
Vou should always call FILL after 
using the HIRES command for the first 
time, otherwise pictures tend to 
appear scrambled. 

(The last three commands came out 
of my use of DOODLE, but should be 
compatible with similar art packages). 



Basic INK x - Changes the character colour 



hich enables the sprite to be moved 
with a joystick- in Port 2. The sprite 
can be moved to any position on the 
screen but will not wrap perfectly. 
The sprite definition is controlled by 
location 2040 decimal. I have not 
included a default definition, this I 

imagination. 

POOL x - Changes the colour of the 
pointer. (Note that the pointer is not 
set as multi-colour). 

POS x,y - Enables you to set the 

pointer position from to 344 in the 
x axis and to 255 in the y. Any 
value for x above 255 is handled by 
the program, and the x coordinate bit 
is set or cleared automatically. The 
pointer is still under joystick control, 
and that this use of POS will not 
interfere with the normal Basic use. 

DEFAULT - This acts as if the 
following sequence had be entered, 
LORES:INK14:BORDER14:BAOC6 

If none of the above commands are 
recognised, an error is returned by 
the B.O.S.S. and program execution, 
if any, is stopped. This is, in effect a 
syntax error with a different message. 
The 'SPA' in the message is an 
abbreviation for SPANNER, which 
just happens to be my computer 

B.O.S.S. is entirely self contained 
in the present range of C000 to C700, 
which is 401 52 to 50944 decimal. 
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SCREEN 
DESIGNER 

Creating your own impressive screens gets another boost 
from this handy utility program. 



);■ function 






A WARRINER 



the utility is maris; up a of a couple 

described. 

SCREEN COMPILER 
(address 52000-52775} 

Tlii^ |)n.)];i,iin copies tin 1 current lores 
screen being displayed and creates a 
si and alone: in.nhini- code progr.im 
which will re-create the screen, The 
program automatically detects Ihe 
video hank, screen address, character 
set pointer, colours and colour mode 
being used and restores ihese values 
when Ihe screen is re-created. 

The compiled code uses ten zero 
page addresses from 165 to 174 
inclusive. To compile a screen, prinl 
the screen, then sys 520O0,AD: where 
AD is the address at which the code is 
to be compiled, the program will 
return the end address of the code. To 
re-create the screen simply enter sys 
AD. The screen data is not just stored 
as a block of data, but is compressed 
according to ihe following method. 
The program searches from the start of 
the screen memory until the first 
character which is not a SPACE {#32) is 
found, this is the start of the screen. It 
then searches from ihe end of the 
screen, backwards, in the same way 
and marks this as Ihe end of the screen. 



the screen, the current colour variable 
(CURCOL) is stored in the 
corresponding colour memory. 

If the data value is greater than 1 27 
then it is deciphered ihus:- 

If bit 4 is set then bits to 3 hold 
the new colour value (CURCOL) 

II bit 5 is set then REVFLAG is 
Hipped, i.e. reverse on becomes 
reverse off and vice-versa 

If bit 6 is sel then ihere are a 
number of characters of Ihe same value: 
to he repeated, in which case, the next 
data byte represents the number of 
characters lo be done, and, the byte 
alter tlt.it holds the character value to 

More than one bit may be set at a 

If bits - 6 are zero then this is the 
last byte and the routine exits 

The program "compiler 52000" i 
Ihe disk is a ba^i. louder for "compil 
code", cvh id i is ihe program itsell 

SCREEN 

DESIGNER/COMPILER 
(address 16384-28374) 



CTRL+F1 - Enter block mode. 

In block mode you must follow the 

lollowing sequence. 

Move cursor lo upper left corner of 

block and press RETURN. 

Move cursor to lower right corner of 

block and press RETURN. 

The block is now defined and may 

be moved around the screen with the 

cursor keys, in addilion:- 

RETURN - will print the block. 

Any COLOUR key will fill the block 

with that colour. 

F7 - reverses all of the 

characters in the 

block. 
RUNSTOP - will prinl Ihe block 

CLR - dears the block and 

Continuing lirnctinn key definitions 
f 3 Insert a blank line 



F4 

CTRL+F3 - 
LOCO+F3 - 



nuptc 



This 






The 



s Iher 



compressed and stored. When the 
screen is re-created the screen is 
cleared and the video parameters are 
set, the data is then read and 
interpreted as follows:- 

If the data value is less than 128 
then il is OR'ed with a variable 
(REVFLAG), which determines if 
reverse video is on or off, and stored to 
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design and compile screens. 

When the program starts you are 
presented with the main menu from 
which you may select an option by, 
moving up or down the menu with 
the cursor keys, or, by typing the 
inilial letter of the option, the options 
are as followsr- 

DESIGN SCREEN 

In the designer you may type in 

characters and change colours in the 

normal way, but in addition the 
function keys will give the following 

F1 - Centre text on cursor 



CTRL+F5 - Incremeni border 
(SHIFT+CTRL+F5 



screen and border) 
LOGO+F5 - Switch cursor off, any 



F7 



Reverse oil. 



F8 - Switch Forcecolour/ 

■ Copycolour mode. 
Forrecolour is the normal typing 
mode in which the character printed 

copycolour mode ihe character is the 



[° 



ON THE DISK 



colour of the existing characl 
the screen, unless, that colour 
background colour in which 
last, selected, colour is used. 
CTRL+F7 - Paint w 

In this mode as the 



other than the cl 

LOGO+F7 - Draw will- 
character. 
In this mode the character which 
under the cursor when the mode 

selected is printed as the 

determined by Forcecolov 



To exit ihe designer press RUNSTOP to 
return to the main menu, or, 
SHIFT+RUNSTOP to call up HELP 



will call up the designer help 
ens. RUNSTOP returns to main 
u any other key calls second help 



VIDEO PARAMETERS 
On this screen you may select the 
video bank, screen address, character 
set pointer, colour mode and colours 
used by the designer and compiled 
code. You may also view the selected 
character set. Certain addresses are 
not available as they are used by the 





■BBBBBBm 
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COMPILE SCREEN 

On this screen you will be prompted to 
enter the address at which you want 
the designer screen code to be 
compiled, if you have previously 
compiled a screen you will be 
informed of the next available address 
to allow you to create consecutive 
blocks of code, pressing RETURN 
without entering anything wilt 
automatically compile at this address. 
You will not be allowed to compile 
code which overwrites the program 
this is not a problem as you can 
compile the code In a different nrklnv. 
and then use the seperate screen 
compiler to move it to your desired 
location. Oni e rode is compiled you 
have the option to save the code in 
which case you will be prompted for a 
Code may be compiled and 
under the I/O area and 




under the Rams, but, only code under 
Ihe Basic Rom (40960-49151) may be 
saved. The program uses the area 
under the Kernal Rom (57344-65535) 
as a workspace and so any code 
compiled there may be corrupted. 

RECALL SCREEN 

This allows you to put a previously 
compiled screen into the designer, 
also, all of the video parameters are 
read from this code, li no code is found 
at Ihe address you specify then you will 
be asked if you wish to search for 
code, if you do then the program will 
search from that address until valid 
compiler code is found which is then 
loaded into the designer, you may then 
exit or continue to search. 

IOAD/DIRECTORV 

Selecting this option ,illows you to view 
the disk directory and load from it. You 
are not allowed to load code whose 
start address is in the program memory 
space. When code is loaded the load 
start and end addresses ,ire displayed. 
and, if the code is a compiler screen it 
is loaded into the designer and a red 
asterisk I') is displayed to inform you 
tins lias happened. 

QUIT 

Reset computer. Re-enter program with 
sys 1 6384. 

The program "Screen Designer" (2049- 
3014) on the disk is a basic loader and 
loading screen for the main program 



[onThe disk I 
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screen is made to be in multicolour 
mode, and the multicolour changed 
constantly. So if the colour memory 



A guide to scrolling landscapes on the Commodore 64 for beginners. 
First and foremost let me just point „,...,,_ -,,-.-„ . 

out one thing. On some older C64's, EDMUND DUMBILL 

the colour memory may need to be 

set each time the routine is called, by scrolling is ruined as large gaps rra 

POKEing to it. (55296-56295). On back and forth at the side of t 

the more recent models, simply screen. To shrink the screen in the 

selecting the colour by POKEing direction, you must set bit 3 

646,n will do the trick. Note that this 53270 and the y-directi 

is only if the routine does not at first 53265. One of the m 

appear to work. uses of scro || [ng is ,„ providi a 

Qneof the first questions budding landscape for a spaceship etc in a 
game. This is most commonly done 



thai 



15 the 



young programmers 
I get to screen to scroll?' How 
indeed? First, the scrolling must be 
achine code as Basic is 



assignment will appear to glitter as 
r changes. The routine 
illy update the colour 
is advaisable only to 
on the screen. Before 
you try to use the landscape routine, 
you should POKE the colour memory 



i 3 of the 

it 3 of does not 

nmon memory, 



done from n 



1 tO 3 



n flicker 



Scrolling uses special hardware 
provided by the VIC chip. In 
essence, all that is needed is to 
update a 3 bit (0-7) counter, and let 
the VIC chip do Ihe rest. This of 
course, does not move the characters 
on the screen into different screen 
memory locations, but it shifts the 
whole of the screen several pixels to 
the left/right up/down. There are in 
fact 2 scroll counters, x-direction 
(horizontal) and y-direction (vertical). 
To gain the left effect as opposed to 
the right effect, you must decrement 
the 3 bit counter, and vice versa to 



ii 

LEFT A BIT, RIGHT A 

BIT, DOWN A BIT .. . 

SCROLL 

33 

from right to left, that is 
decrementing the 3 bit counter 
53270. I will now give a program 
breakdown of a landscape scrolling 



i proper 



. (Set 



ings for your 
Jte at start of 



shall n 



3 di:!,lil 



Ihe interrupt routine works, a; 
not pertain particulary to scrolling 
(Eric Doyle wrote a series of interrupt 
articles in your commodore in 1988- 
1989). Every 50th of a second, the 
; called. On being 



:allei 



i the speed 



THE ROUTINE 

The 






go right. The process is the same for providing a landscape 256 characters 
the y-direction. To move characters ' 
on/off the screen, a simple piece of 
machine code is needed, which 
copies every character on the screen 
either one character to the left/right 
up/down. So now we know basically 
may be 



counter and then scrolls one pixel t( 
the left. The state of the scroll 3 bit 
counter at 53270 is actually stored 
separately in JC0FF. It is checked if 
the scroll counter has reached zero, 
if so, it is time to shift the screen one 
character to the left, and to reset the 



all the 



how scrolling 
asking the question; where 
mythical registers? A quick 
consultation of the users guide will 
assist you. The y-direction is bits 0-2 
of location 53265 and the in- 
direction is bits 0-2 of location 
53270. To achieve neat scrolling you 
must 'shrink' the screen so you can 
hide the characters you are putting 






o the si 

don't do this thi 



long by 11 lines deep. The landscape 

is actually interrupt driven, so your scroll counter. If you did this in 

program can be getting on with its Basic, you would be able to see the 

own business while the landscape apparent spectacle of the whole 

scrolls along. Another aspect of screen shifting back 8 pixels, and 

interrupts Is also brought in; the split then shifting back 8 pixels again with 

screen. As the landscape is only 11 the new screen data. Obviously 

deep, we want the other 14 machine code is too fast for the eye 

een is split to see what is going on. The process 

at the 12th line. As a novelty, I have of updating the 3 bit counter is 

md " ded TU a vari L able 5 P"d of continued for as long as the speed 

scrolling. This is achieved by instead counter says. The speed counter is 

of scrolling the screen 1 pixel every located at SC0FD, Shifting the whole 

50th of a second, scrolling the screen screen one character to the left is a 

by any amount stored in a memory laborious job, of which there are two 

_ location. The number in this location ways of going about it. The first way 

the^ border If you consequently becomes the speed is the way I've used, which is to shift 

further novelty, the one row at a time with seperate 



effect of 



commands and then to shift the new 
data in from $C300 onwards. This is 
rather a long winded way, and a 
beirer way, but more complicated, 
would be (o use extensive indirect 
addressing to shift all data in and 
out The advantage of a long winded 
way is that ii is often the faster way, 
as in this case. There is a pointer 
which keeps track of where the 
computer is along the landscape. 
This counter is located at SCOFE, and 
is decremented every time the screen 
is shifted one character to the left. A 
few pointers are used from $C200- 
$006. You can try altering them if 
you want, $C201-$C202 control 
border colour around and below the 
landscape, and $C203-$C204 the 
screen colour. $C205-SC206 control 
the position of the screen split. You 
can try splitting the screen at 
different places to alter the scroll, but 
remember that the shift routine does 



TO USE THE ROUTINE 

The landscape data used by the 
computer is at SC300 and ends at 
SCDFF. The data is stored as screen 
codes not as ASCII data. There is no 
easy way to POKE in your landscape 

tt 

TRY SPLITTING THE 

SCREEN AT 

DIFFERENT PLACES 

FOR GOOD EFFECTS 

» 

data, apart from to write a landscape 
designer program. It is probably best 
to use a character set that you have 

defined especially for ihe landscape, 
but I have designed a landscape that 
uses I In-' default i hrinicter set. To start 



the landscape going simply select it 
from Ihe CDU menu or alternatively 
load it independantly and type 
SYS49152. For the more inquisitive 
amongst you the following is a 
breakdown of the main program 

$C000-$C025 - Setup variables and 
interrupt pointers 

$C026-SC06S - Main interrupt 
handling routine. Deals with split 
screen and border colours. 
IC070-$C07F ■ Decides whether the 
landscape routine should be called, 
and calls it if needed. 
$C0BA-$C15F - Shift screen one 
character to the left routine. 
Interposed with variables as already 
mentioned. 
$C1 60-SC1 87 - Main scroll routine. 

I hope this short introduction into the 
art of scrolling will prove to be of 
some benefit to you. Especially to the 



WINDOWS 128 

Storing and recalling windows is simplicity itself with this 
handy C1 28 routine. 

While designing a short program for JASON DOIG 

my CI 28, I decided to use some 

windows to make the display more 

attractive. Then I remembered how 

Commodore had 'forgotten' to 

include any window saving routines 

in the Basic. Thus, I resolved to write 

this wedge which would record the opened will be lost. 

screen contents, (including colour), 



ail the 



Enter this; SYS5381:CLR This will 
also reset the windows stored to 
ndows previously 
good idea 
place this at the bagining of your 
yii.ne d WINDOW command programs. The reason for the CLR is 
reached. Also wedged was an to clear the variable area which has 
which been moved to make room for the 



)uldc 



fethe. 



it window and 
recall the old screen. Up to 9 
windows can be opened 110 
including the original screen). 

So, how do you use the routine 
First of all you will need to load ir 
the wedge by BLOAD"WINDOW_S" 
<return>. Thatw " " 



ndows which will be stored in 

,NK 1 underneath them. Now 

NDOWS will be installed until the 

machine is reset, (after a reset, using 

the above SYS call should re-install 

WINDOWS without re-loading). 

The WINDOW command 
operates as normal, except only 9 
into memory from $1400 to $17FF may be used in a row. Any more and 
(5120-6143). Now you should memory is filled up resulting in a 
transfer the routines into both RAM syntax error being generated (as 
banks (To avoid crashes when using opposed lo variables being 



corrupted). 

To restore screen contents after a 
window is finished with enter the 
command - WINDOW* - this will 
remove the last window opened and 
decrease the window counter. 

There is another useful feature of 
this program. After opening a 
window it can be bordered and 
shadowed. Use the command 
SYS5696,<border colour>,<shadow 
colour;-. This will place a border 



t- iioin (i li. 



around the cui 
shadow it. The c 



One small point to note is that 
your variable space is reduced to 
about 40K. This should not cause 
any problems, but be careful not to 
go overboard with enormous arrays. 
The program also uses *ero page 
250-255 ($FA - $FF) addresses. To 
see the wedge in action LOAD and 
RUN the program 'Window demo' 
after BLOADING WINDOWS. One 
last point worlh mentioning. 
ALWAYS home the cursor after 
opening a new window, otherwise 
strange things have been known to 
occur (but very rarely). 
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SAMPLE KIT 




b compliment last months program 'Sequencer 64' by Steve Carrie, I present a sample 
program of my own creation 



The SAMPLE KIT 64 was originally 
designed for use by owners of the 
excellent digital sound sampler from 
Datel Electronics. However, even 
those without the sampler hardware, 
can have hours of fun by using this 
kit, with the accompanying 
d em (.mstr.it ion sound sample, and in 



the pro 



indie 



n of 






THE KIT IN USE 

The kit enables a sound sample to be 
'chopped' into individual parts, 
known as the SAMPLE SPLITS; these 
'sounds' can then be linked together 
in a sequence, known throughout ,is 
the TUNE. Edited tunes can be saved 
to disk, and data created can be used 
to playback the tunes within your 
own programs. To aid in this I have 
Included a source file named 
SAMPLEPLAYER.ASM, which can be 
■issemblerl by llie MIKRO assembler, 
and CDU's very own 6510+. 



sample file, which is treated with 
Datel Electronics "Sampler 64" 
software/hardware package. The kit 
requires you to save the sample data 
from Datel's utility as a full 32K file. 
This is a save range of 0-8, (a sample 
split of 1); see the sound sampler 
instructions manual for more details 
of setting the sample save range. 
Other sound sampler data files may 
be compatible with the kit, but I have 
only had chance to use Datel's unit. 
So, if you have another sampler, why 
not try it o. 
By using 



. full 



to the final tune. 

SAMPLE KIT EDITOR 
SCREEN 

The screen display is split into tw< 
main areas. The top of the screei 
comprises of the SPLIT METER, this i 
the display on which the sampli 



splits are tested, and created. The 
area below is the CONTROL PANEL, 
coming complete with a selection of 
'function buttons'. 

ACTIVE MODES 

Whilst on the editor screen, you can 
be in One of two modes of operation, 
each is denoted by a particular 
i nloured border:- 

BLACK border - control refers to the 
CONTROL PANEL (lower region of 

BLUE border - control refers to the 
SPLIT METER (upper screen region!. 
To toggle between the two modes 
press the SPACE BAR. 

CONTROL PANEL MODE 

The 'function buttons' are operated 

by positioning a pointer over the 

made by pressing fire. All control is 
via a joystick in port 2. The available 
function buttons are; 

1 - Increase step in tune (CRSR up 

key - optional). 

2 - Play tune - press space to 
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TUNE FORMAT 








A typical TUNE c 


on Id be of the (allowing form: 






Command/Split 1 


plav 


Krpi.-.ii/f.wameter 


Step 


<;Commenl> 


SP 




03 

05 


00 

01 


Delay 05 


00 




01 


02 


Play sample 
split 00 once 


02 




10 


03 


Play split 
02 16 times 


BLANK 




00 


04 


Exits 



3 - Decrease step in tune (CK5R 

dawn key - optional). 

4 - Selectarea in tune window to 

edit. 

5 - Increase parameter of selected 

item (; key optional). 

6 - Decrease parameter of 

selected item (= key optional). 

7 - Delete highlighted step in 

8 - Insert before highlighted step 

9 - Exit to file menu. 

Note that keeping the space bar 
depressed (toggling between the two 
nodus of ope itton}, and at the same 
time pressing the fire button, slows 
down thp effect of a selection. This 
. i' be ■.-■■iul if you seem to race 
through values, and require a 'finer 
resolution' when selecting. 

SPLIT METER MODE 

The two sample split indicators, 
appearing on the meter display 
(white=start split; red-end split), can 
be moved by using the joystick in the 
horizontal, and vertical dim linns tor 
each indicator respectively. In effect, 

complete sample inio 128 different 
sounds (shown as hexadecimal 00- 
7F), To select a particular split to 
edit, use the F1 and F2 keys. Press 
lire to test the sound split, and once 
the sound is as you require, store the 
information by pressing F7. Note that 
without pressing F7, no new sample 
split information will be stored. The 
border will rapidly flash colour to 
Tt that data for ihe sample split 



has bee 



I pi.FI |Ji>'!T- 



only, the speed of the playback can 
be changed by pressing the F3 and 
F4 keys. The speeds can range from 
S0O-JFF (0-2551, and is the delay 
liftui-i.-n 1. 1 1 1 ■ | hi ii i ■-.-,■■■■;; !j| bih when 
playing back a sample. Note that a 
speed of gives the largest delay, 
being equfvilant of 256. The sound 
quality heard in this lest mode will 
rial be as clear as when the tune is 
re-played, this is because the screen 
interrupts are not disabled, but will 
suffice for lest purposes. 

TUNE FORMAT 

The tunes are displayed in the TUNE 
WINDOW, this is the area to the 
right of the first block of function 
buttons. Each step shown in the 
TUNE WINDOW comprises of; XX 
YV ZZ; where XX relates to either a 
value in the range S00-$FF, this 
being the sample split number to 
play, OR a command:- SP=select 
speed to play subsequent sample 
splits; WT=cause a specified delay 
before ihe next step in the tune fs 
processed; RE=command to restart 
the tune. A blank space in this area 
signifies the end of the tune. The 
hexadecimal value referred to by YY 
can be either the number of repeats 
of a sample (if a value S0O-I7F is 
specified.!, or ,i parameter value to be 
used with one of the SP/WT 
commands. Note that both the 
command RE, and a blank space, do 
nol lake the value of YY inlo 
account. To make either XX or YY as 
the field to be edited, select the "< 
>" function button, (it will toggle 
between XX and YY). A circle marker 
will appear above the relevant 'XX' 



or 'YY' field. When this appears, 
selecting the "+" and *-* function 
buttons will increase or decrease the 
field value. The value ZZ is the step 
number in the tune. 

DEMONSTRATION FILES 

I liiivt! supplied a demonstration I j It?. 
and tune/split information. The 
relevant sound samples are suffixed 
with ".SAM", tune information with 
".TUN", and split information with 
".SPL". To listen to the demonstration 
file, named MISC, enter FILE menu 
selecting the FILE function button 
when you wish to load and save 
data. From the FILE menu; 
select option "LOAD SAMPLE FILE" - 
enter name as "MtSC.SAM", select 
oplion "LOAD SPLIT DATA" - enter 
name as "MISCSPL", select option 
"LOAD TUNE DATA" - enter name 
as "MI5C.TUN". When you have 
loaded in the required sets of data, 
select the play function button on the 
control panel to listen to the demo. 

PLAYING A TUNE IN YOUR 
OWN PROGRAMS 

Enter the file menu by selecting the 
FILE button on ihe editor screen. You 
will need to save the SAMPLE SPLIT 
DATA, this contains the start and end 
addresses for all of the 12S sample 
splits. Also, a TUNE DATA file is 
required, this contains all the 
necessary control codes for speed, 
delay timings, and a sequence of 
sample splits to play. Most notably, a 
copy of the sample file is required to 
re-play the tune. The quality of 
sound reproduction is greatly 
improved by disabling the screen (by 
clearing BIT 4 of location SD011). To 
add to this effect, the interrupts are 
also disabled with SEI throughout the 
playing of Ihe tune. Please refer to 
Ihe source file (SAMPLEPLAYER. 
ASM) for some documentation on 
memory usage and handling of ihe 
tune/sample split data. 

Finally, even if you haven't obtained 
Datel's digital sound sampler to 
sample your own sounds, I hope you 
enjoy playing around with the kit - 
hopefully not annoying anybody in 
Ihe process so turn up the volume! 

23 



FEATURE 



1581 Internal 

Disk 
Commands 

Getting to grips with the 1581 disk drive is explained in an easy to understand manner. 
PAUL TRAYNOR 



1581 Memory 






The memory can be spFir into the following areas; 




$0000-$1FFF(#0-#8191) 


RAM, which can be split into the following; 


$0000-$OOFF (#[)-#255) 


Zero page, job queue, variables. 






The zero page contains many of th 


ini!)uri:in; par a merer, which are required by 




DOS. The job queue enables the the controller and DOS to commur 




each other. 




$0100-$01FF(#256-#511) 


Stack, variables, vectors. 






The RAM vector addresses found here are the ones which can be altered to 


disable 


commands such as scratch or the n 


a w command 


$0200-$02FF(#512-#767) 


Command bulk- tallies, variable-.. 




S0300-$03FF(#768-#1023) 


Data buffer 




50400-S04FF(#1024-#1279) 


Data buffer 1 




$05OO-S05FF(#l2B0-#1535) 


Data buffet 2 






I )aia butter 2 is the one where the 


ser commands u3-u8 (or uc-uh) will jump to. 


J0600-J06FF (#1 536-#1 791 ) 


Data buffer 3 




$0700- $07FF (#1792 -#2047) 


Data buffer 4 




$0800-$08FF (#2048-#2303) 


Data buffer 5 




S0900-S09FF (#2304-#25S9t 


Data buffer 6 




SOAOO-$0AFF (#2560-#2B15) 


BAM for first 40 tracks 




S0BO0-$OBFF(#2816-#3071) 


BAM for last 40 tracks 




$OCOO-$1FFF(#3072-#B191) 


Track Cache Buffer 






The track cache buffer helps to incr 


■jio flu- s|K-(-d cm iiijjut/oiilpiil operations. This 




is because all access involves whole physical tracks which are stored in the track 




cache buffer. If more than one sector is to be read and they ate all on the same 




track then only one disk access wil 


be performed, further sectors will be read 




from the track cache buffet, 




$4000-S5FFF (#1 b384-#24575 


Serial Bus I/O 






I/O is controlled by a 8520A CIA cF 


p 


$6000-$7FFF (#2457()-#32767 


Floppy Disk Controller (FDC) 






The FDC is a Western Digital 1 770 


]r more recentlyl 772 


$8000-$FEFF (#32768-#65279) 


32K ROM, DOS and controller rout 




$FFO0-$FFFF (#65280-#65535) 


Jump table, vectors 





FEATURE 



The Internal Disk Commands allow 
the user to manipulate the memory 
of the disk drive. It is also possible to 
run machine language programs in 
the memory of the drive. As with 
Direct Access Commands care must 
be exercised when using these 
commands, especially if the user has 
no or very little experience. 



80 for j=l (on 

90 get#15,x$:ifx$=" 

x$=chrj(0> 
100 prinl asc(x$); 



GENERAL RULES 


device number fit) to be tested is 


When you are first using Internal 


in lin 


e 10. 


Disk Commands you must be aware 






that any error in programming can 


10 


x=9 


lead to the drive hanging up, and Ihe 


20 


open!5,x,15 


only way to regain control is to 


30 


openl,x,8,"#1" 


switch off and then on again. If a 


40 


print#l,"m-r"dir$(198ichr$ 


programming error has lead to the 




(229}chrS(1) 


drive motor and green light 


50 


get#l,a$ 


remaining on, then the only way to 


60 


ifasc(aSJ=0thendr$="!581 


safely regain control tie. avoiding 




elsedrS="1S71/41" 


corrupting datal would be to reset 


70 


closel 


the computer. Therefore 1 advise that 


80 


close! S 


you should save all programs before 


90 


printdrj 


running them. 






COMMANDS 




ft 


Memory Read 


EXE 


Wilh the memory read command 






you can access any of the addresses 


WHE> 


within the disk drive's memory. 






Memory-read is the drive's 




COMMANDS. 


equivalent of the BASIC PEEK 






function, the command format is 




)J 


shown below. 







program will put a machine language 
routine into data buffer 2. Operation 
of this routine is explained later in 



10 0pen15,9,15 

20 y=0 

30 readx:ifx=256thenend 

40 printffl 5,"m-w"chr$(0+y)chr$ 

(5)chr$(1)chr$(x); 
50 y=y+1 
60 gOto30 
70 data 76,7,5,32,229,129,96, 

32,241,129,165,118,197,118, 

240,252,96,256 

Memory Execute 

Wilh the memory-execute command 
you can execute any routine in drive 
memory RAM or ROM. Memory 
Execute is the drive's equivai 
the BA5IC SYS command, th 
i iiir.m.ind formal is shown below. 



print#15,"m-r"chr$(l>chr$(h)chr$(n) 
where; l=memory address low order 

h=memory address high order 
n=number of bytes 

The first example program will 
read any address of disk memory and 
up to 255 bytes at one time. The 

address should be entered in decimal 

10 open 15,9,15 

20 input" jdownl number of bytes 

to read (0=finish)";n 
30 ifn<1 then close 1 5:end 
40 if n>255 then 20 
50 input "starting al adrlress":ad 
60 h=int(ad/256):l=ad-h*256 
70 print#15,"m-r"chrS(l)chr$ih) 
chrS(n) 



of 



Memory Wrile 

The memory- wrile command allows 

within the disk drive's own RAM. 
Memory-write is the drive's 
equivalent of the BASIC POKE 
command, the command format is 
shown below. 

print#15,"m-w"chr$(l|chr$(h]chr$ 
In)chr$(dl)chr$(d2)....chr$(dn) 
where; l=memory address low order 

h=memory address high order 

n= number of bytes 

dl-dn=data bytes 

You can wrile up to 35 



prints] 5,"m-e"chr$(l)chr$(h) 
where; l=memory address low order 
h=memory address high order 

To show the memory-execute 
command at work, load and run the 
memory-write example program, 
(note that channel#15 should still be 
open), and then enter the following 
command in direct mode. 

print#1 5,"m-e"chr$(0)chr$(5) 

This first command will switch 
the drive activity light on. 

This next command will then 
switch it off. 

prin»15,"m-e"chr$(3)chr$(5) 



(0"H"Jru1 ii ,ind the internal disk 
command 'm e\ The data or 
program in the sector will be read 
inio : ( buffer and then executed. 
The iomrr.ind format Is shown 
below. 

pi ■"\ . :.. ."Mnnel#;drive#; 

trw k#au<1onS 

printtM , ber!v-nel#,drive#, 

'ijiks.seirci'" 



FEATURE 



A programming t- 

block-execute comma 

the 1581 user's guide. 



USER COMMANDS 

User commands tell the 1SB1 
execute programs starting at cert; 
predefined locations or addresses 
it's memory. Below is a table of u: 



locations. This is sufficient room for a 
machine language IMP command 
allowing you to use longer routines 
that can be initially called up by 'u' 
commands. To show an example of 
the user commands at work load and 



, (nc 



el#15 



User 


Function 


Command 




uO 


Restores default 




user jump table 


ul or ua 


Equivalent of Hired 




Block-Read 


u2orub 


Equivalent of direct 




access command 




Block- Write 


u3 or uc 


lump to RAM data 




buffer #2, Location 




$0500 (#1280) 


u4 or ud 


Jump to RAM data 




buffer #2, Location 




50503 (#1283) 


uSorue 


lump to RAM data 




buffer #2, Location 




$0506 (#1286) 


u6 or uf 


lump to RAM data 




buffer #2, Location 




$0509 (#1289) 


u7orug 


jump to RAM data 








S05QC (#1292) 


u8oruh 


lump to RAM data 








$050F(#1295) 


u9orui 


lump to the reset 




tables, Location 




$FFFA (#65530) 


uioruj 


Power up vector 



should still be open), you will notice 
that m-w example program loads the 
program into data buffer#2 which is 
the one where the user commands, 
u3-u8 (uc-uh), jump to therefore this 
program can be operated by user 
commands as well as the 'memory- 
execute' method previously shown. 
When you have run the 'm-w' 
example program enter the following 
command in direct mode. 



H5,"u3" 



This 



land v 



nd v 



the drive aith i tv hi>ht on. 

This ne: 
switch it off. 

print* 1 5,"U' 



UTILITY LOADER 

The utility loader Is the command 

which will load a USR file from disk 
into disk drive memory where ii will 
then execute. The format for the 

utility loader torn ma nd ii as ml lows; 



prinl#15,"ucharacter"; 

The character is taken from the 
above table. 

Although there is only space for 
three bytes between each of the u 
commands (u3-uB) jump-to 

26 



print#15,"&0:fi 



USER FILES 

A user file has !< 
guidelines. It is lit 
sector of a disk a 
constructed as belo 



Slarl address low order 
Surf address high order 
Number of program 
Program code bytes 



checksum byte will immediately 
follow the last program byte. The 
checksum is calculated by adding all 



the values of the bytes, starting at the 
low order start address (byte 0) 
, while adding you round down to 
zero every time you reach 255. 

A method of creating user files is 
to open the file as you would a 
sequential file (except using ,u,w 
instead of ,s,w) and then read into 
this file, from data statements for 
example, the values of all the bytes 
starting at byte 0. Below is the 
framework for a program which will 
create a user file on disk which can 
then be subsequently executed by 
the utility loader command. 

10 open2,9,2,"0:&filename,u,w" 

20 read d;ifd=256 then 40 

30 print#2, chr$(d); :goto 20 

40 close2:end 

50 data I :rem start address 

low order 

60 data h :rem start address 

70 datan :rem number of 
program bytes 



n program code 






data c :rem checksum 

i data 256 :rem program dat. 

finished 



AUTO BOOT LOADER 

When any of the following functions 
are performed; power up, reset, burst 
inquire, burst query.or the initialize 
command, a user type file named 
"copyright cbm 8b", if present, will be 
loaded into disk memory and 
executed. After executing the program 
must call the JCBMBOOTRTN to 

three methods of disabling the 
automatic loading of this file; 

Setting a flag in the BAM, Byte 7 
track 40 sector 1 (there is also a copy 
in byte 7 track 41 

Setting a flag 
JDEJAVU jump table vector 
mentioned in the user's guide is at 
location $ff60 (#65376) and that uses 
the SWITCHAUTO at location $9145 
(#37189) 

The third method of disabling the 
auto boot loader is the simplest and 
lhat is to just rename the file. 



a RAM, The 



ADVENTURING 



ADVENTURE HELPLINE 



JASON FINCH Continues his aid to those Adventurers stuck in the middle of 'KRON' 



have concerned themselves with 
completing the adventure Kron, 
written by Tony Rome and published 
by CDU in December 1 989. 

However, although a solution was 
given to each problem, the help 
provided was of a Very cryptic nature 
and no! everything was revealed 

.■n< lull tig IhSs one} will virtually 
dupllt ate the motions of the first 
three but (hi*, time each of the fifty- 
tour lot ,iii(i''s will be described in 
de'.ii .ni'l i-i L commands given that 
vii. -hc.kl tvpe in each location to 
sm c .'"Mil v i omplele the adventure. 
Nm oniv that but the results of your 
dcliuiu are aiso listed, logether with 
all exits and where they lead. I am 
no! going to tell you which ones to 
take until the end because they will 
be different if a location is visited 
twice, once on going somewhere 
and again on returning from that 
other location. I shall, however, 
inform you of directions that you 
should not take. Suffice it to say that 
following these and the broad 
directions given in the other three 
articles you can't go far wrong. Each 
location has been given a number, 
the first being, quite obviously, 
number one. The layout is quite self- 
explanatory but for the first location 1 
have provided details of what you 
need to know. And in this issue stage 
one, the first twenty-three locations, 
will be recreated for you. Let the 
story begin... 

1. At the Lagoon of Stars, Rocks 
surround the beach while to the easi 
strelches the dreaded Sea of Storms. 
(this is the main description of ihe 

n exactly how ii is worded on 



the* 



n.) 



location numbered two in this series. 
These exits are not necessarily the 
only ones because new ones can be 
discovered by performing various 
operations) 

Type: EXAMINE ROCKS - boat 
appears (only type what is given in 

represents the results of Ihe action. 
This text should only be used on the 
first entrance to the location. Upon 

returning just go where you see fit. 
There may be, like in this case, more 
than one line of text, so type the first 
followed by the second and third and 

GET BOAT 

It 

ALL THE NICE GIRLS 

LOVE A SAILOR 

» 

2. On the Sea of Storms east of a 
cove. The waves scream like angry 
vultures waiting to devour their prey 
as they rise and fall in a tortuous 
rhythm. 

Exits: WEST 1 

Type: HOIST SAILS - allows south 
and east movement (to 8 and 3 
respectively) 

Other info: Do not drop the boat 
at any stage when you are in the 

mercilessly against the small boat. 
<its: EAST 4, SOUTH 9, WEST 2 

, In open sea. To the south is a 

Hind of rushing water. 
Exits: EAST 5, SOUTH 10, WEST 
3 

Other info: Do not go south 

5. On the northeast coast oi Sark. To 



.1 .- the : 



noldrr 



ands on a cliff overlooking Ihe sea. 
is moon moves behind the dark 
ouds as they scud across the 
oomysky. 

Exits: WEST 4 

Type: WAIT - moonlight reveals 

Other info: If you have just 
uncovered Ihe steps, go up them. If 
coming dawn, temember to pick 
your boat up again as it will have 
been left at the bottom of the cliff. 

6. In open sea east of a treacherous 
rocky inlet off the northwest coast of 
Sark, To the south shrouded by mist 
is a strange rock. East is open sea. 
Exits; EAST 7, SOUTH 12, WEST 

Other info: Vou may here cries 

elsewhere in the adventure. 



8. The sea stretches in all directions 
.ind bearing south is a tiny island. 

Exits: NORTH 2, EAST 9, SOUTH 
14, WEST 7 



9. In open • 



o Ihe east 



of 



Exits: NORTH 3, EAST 10, 
SOUTH 15, WESTS 

Other info: The sound of rushing 
water to the east is in fact a deadly 
whirlpool. Under n 



>uld rt 



suit in 



death. 

10. The boat is caught in a deadly 
whirlpool! Vou are slowly sucked 
lto its spiral path... There is no 
scape... 

Exits: none 

Other info: This location 
^presents certain death. Entering 




here results in you being k 
without a chance to escape. Do not 
enter this location. 

11. In an old Boran monastery which 

beautiful stained glass windows are 
now either cracked or broken. Steps 
lead down to the shore. 

Exits: DOWN 5 

Type: EXAMINE RUINS - a scroll 
appears 

TAKE SCROLL 

Other info: The only way to go is 
back down the cliff. When at the 
bottom remember to take your boat 
again or else you will drown. 

12. On the Rock of Akron. A 
greenish mist surrounds you and 
voices whisper your name... or is it 
just the sound of the wind hurrying 
across the sea... . 



a clam 

OPEN CLAM - this can only be 
done if you are holding the bar 
which is found in location 16. On 
opening the clam you find an old 

TAKE LAMP 

Exits: NORTH 7, EAST 14, 
SOUTH IB, WEST 12 

14. On Refuge Rock a small island 
totally surrounded by the Sea of 
Storms. A small cave covered with 
twigs is almost hidden from view 

Exits: NORTH S, EAST 15, 
SOUTH 19, WEST 13, ENTER 22 

Type: GET TWIGS 

Other info: If here for the first 
lime, enter the cave by simplv ivpirii; 
ENTER CAVE 

Exits: NORTH 9, EAST 15, 
SOUTH 20, WEST 14 

16. On the northwest coast of Sark. 
The rocks here are jagged and slippy 
under foot. An old withered tree 
stands on a ledge a few feet above. 

Exits: EAST 6, CLIMB 1 7 (see 
below] 



Type: GET BAR 

THROW ROPE - found in 
location 22. The rope will wrap 
around the tree 

DROP BOAT - otherwise the 
branch will snap 

CLIMB 

It 

WHO WANTS TO LUC 

A HEFTY BOAT 

AROUND? 

» 

17. On a ledge above the rocks, A 

branches cracked and dry. In the 
distance is the Castle of Spells 
towering againsl the skyline. 

Exits: DOWN 16 

Type: RELEASE EAGLE - it flies 
away but leaves a flute 

GET FLUTE 

GET BRANCH - this will be 
needed lo provide light later on 

DOWN 

18. Al a rocky inlet on the north 
shore of Sark. Cliffs tower above the 
waterline... A lone figure stands on 
the clifftop! 

Exits: NORTH 1 i 

19. Off the north shore of Sark. 
Ahead are the Caves of Goth. It is 
rumoured thai anyone who enters 
them never returns lo tell the tale... 

Exits: NORTH 14, SOUTH 23 

20. In the Valley of the Storms, a 

narrow waler-way cut through solid 
rock. A few stones loosen and move 
as your boat approaches. To the 
north is open sea and soulh lies the 
land you remember so well... Sark! 
Exits: NORTH IS, SOUTH 21 
Other info: If you go south from 
here then you will meet up with 
death. Do not enter location 21. 

21. In a waterway in the Valley of the 
Stones. Suddenly huge rocks fall 
from the steep slopes!... They smash 
your frail hu.il into small pieces... 



Other info: Like location fen, this 
location represents certain death. 
There is no escape from the rocks 
that fall on you. You will be crushed 

22. Inside a small cave on Refuge 
Rock. This was once a resting place 
for Pilgrims crossing the Sea of 

Exits: OUT 14 
Type: GET ROPE 
OUT 

23. On the north shore of Sark north 
of the great Caves of Goth, an 
underground maze of tunnels and 
pits. Somewhere in the depths of this 
subterranean world is the Cave of Ice 
said to hold the key of freedom. 

Exits: NORTH 19, SOUTH 24 
(covered next month!) 

Well thai just about wraps up the first 
stage in detailed terms. To best solve 
this part you should follow closely the 
following location motions (eg: 1-4-3- 
2-5 means start in location one, move 
to location four and do whatever you 
are instructed in these instructions, 
f hen go to three and do whatever you 
must do there, then to two, and so on). 
One of the "correct" methods is as 
follows: 1 -2-3-4-5-11 -5-4-3-2-8-1 4- 
22-14-8-7-6- 16-17-1 6-6-1 2-1 3-14-1 9- 
23. 

If you follow the movements and 
do exactly what I have said in each 
location you should find it possible to 
move between the locations lhat I have 
illustrated and in that order. Just 
remember NEVER to enter locations 1 
or 21 as these will result in you having 
to start over again. Also, there are 
twelve locations that represent times 
when you are in your boat on the 
walers of the Sea of Storms. Never type 
DROP BOAT or anything to that effect 
or you will drown and remember that 
unless you find land you will die from 
exposure if you stay in the sea for loo 
long (about thirty moves). Next month 
we shall have a look at the next 
seventeen locations which will take 
you up to the same point as you were 
at the end of part two of (his series. 5o 
until then, have fun adventuring... 



ADVENTURE WRITING 

Creating your own Adventures becomes more and more feasible as this series continues. 



Tht' u.ss: 1 11, .p'c n' ;>.IN- of (his series 

jnii background rathe* than the 
a< iim propamming ol an adventure. 
You will have "an I rrre to consider 
whai son of adventure you would 
lib- and wil .'.ivo been able to pick 
and choose wh.ll aspects you would 
like to include. Now though we shall 
actually get to the main PPP5 or Pre- 
programming Preparations. "What?? I 
thought you said we were 
programming this month!", I hear 
you shout. Well we will - but only a 
very small amount. The PPPs must 
be done so that we can structure the 
adventure which, in this case, will be 
programmed mainly in BASIC with a 
touch of machine code to spice 
things up a bit. Remember that text 
compression program that I supplied 
with the first article? Well the 



JASON FINCH 



program in BASIC, never mind. 
To see it in action in my 
COMPRESS program, published with 
the first article, you should load and 
run that program as it stands and 
then press RUN/5TOP when it has set 
itself up with the main screen. Then 
delete lines 540 to 675 inclusive and 
replace them with: 540 POKE 2,CL: 
SYS 49406. Of course, you must 
have first loaded the code, so delete 
Ihe command CLR at the very start 
and replace it with: 5 A=A+I : IF A=l 
THEN LOAD"AW-DECOM.MC,0,1. 



vyou c 



•tthis 



and RUN the program. The code 
' and everything 



s disk 



same, other than the speed at which 
the decompressed text is printed! 

Right then, a minor change of 
subject! The very first thing to do 

come up with an idea for what your 
adventure will be about. Will it be 
fantasy or modelled on reality? What 

fictional world, a house or a futuristic 
setting are all possible ideas. This is 
the creative stage. Draw yourself a 

adventure landscape. My adventure 
will be set in a fantasy world and 
Figure One shows my idea. 

This will be a very small 
adventure but you can see the main 
components. Once you have got a 
basic idea of what will happen in 



ichine 



of I 



decompression routine is on the disk 
this month as well as a further two 
pictures, again created by Doug 
Sneddon. 

These files are "AW-DECOM.MC", 
"PO" and "PIC3" respectively. The 
rihwmhly language source rile is also 
here for machine code programmers 
to have a look at, filed as "AW- 
DECOM.5RC". There are plenty of 
extra comments to tell you exactly 
what each step is doing and it is 
compatible with the 6510 + 
assembler, published by CDU a little 
while back. To load Ihe actual code 
you use the standard ,8,1 suffix and 
execute the code with SYS4940B. 
Before doing this you must enter 
POKE2,L where 'L' represents the 
length in bytes of the compressed 
data. With this routine you can only 
have compressed data up 






:ngth but 



ichine langu^e 
programmer should be able to alter 
the code to allow more. If you only 




ON THE DISK 



your adventure you should create 3 
"square map". This should be much 
more diagramatic with squares 
representing individual locations 
with lines linking them. There are a 
multitude of different methods of 
map drawing that you could use but 
lor simplicity and what I call "ease of 
expansion" use the squares method 
to begin with. It is a lot easier to add 
locations than with other methods. 

If you want to make an adventure 
mare difficult then make certain 
"linking paths" one-way. By this I 

location does not necessarily mean 
that by then going sourh again you 
return to the same place. By 
incorporating features like this you 
can very easily design a "location 
obstacle". This is something like a 
maze and in that case you can make 
all directions possible "exits" but 
only have one that moves you to a 
new location. The others return you 
to the start of the "maze" whilst 
others could keep you in the same 
location. By ensuring that the 
descriptions of these locations are 
the same, ihe player can become losl 
relatively easily. The example 
adventure, Demad, incorporates a 






iplr 



presented by locations 
nine to eleven in Figure Two, the 
square map. 

A number of terms were used in 
the lasl paragraph that I shall now 
clarify. They are all quire simple but I 
shall explain them to ensure that you 
fully understand. Don't forget that 
this PPP stage is very important. 
During your programming you must 
have something to refer to. But first 
ihose terms - and a few others. 

"Linking paths" are merely the 
lines that are shown on your square 
map so that you can easily see which 
directions are available from a 
specific location and to which 
location it leads. The path is not a 
physical part of your adventure. You 
could just as easily draw the squares 
touching with gaps in their sides, but 

"Location obstacles" are feature: 
of your adventure that hinder rhi 
progress of the player. They an 



relaled to the actual location and in 
which directions the player can leave 
that location. This could be a maze 
as mentioned earlier or could be a 
light/dark situation. This could take 
the form of a dark tunnel where the 
player's movement is restricted until 
a lamp, for example, is lit, whereby 
new directions are made available. 
"Exits" is the term that describes 
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FIGURE 2 



which directions ,1 player can move. 
If on a mountain path that runs north 
to south, the possible evils are north 
and south. New exits can be made 
available under different 
circumstances. For example, wearing 
,1 m.igic ring could 'open up" an exit 
to the east that may lead into a cave 
in the mountain. 

"Actual obstacles" are things 
found in the locations, or rooms as I 
shall now call them, For example if a 
l.nrge boulder prevented you moving 
west and it was possible to somehow 
shift it to "open up" the new exit, 
then this boulder is termed an actual 
obstacle. 

"Objects" are exactly what they 
say. They are found in the rooms and 
are the things than can be picked up, 
dropped, opened, closed and so on. 
In the previous example the boulder 
whould also be defined as an object. 
Some food, a key, a cupboard and a 
bag of coins are all examples of 



the general descriptions of the 
rooms, you should mark on the 
position; of the actual obstacles. You 
should have a ratio of about per five 
to seven rooms. This will require 
some thought. Next you must decide 
on how they will be overcome - for 
example the boulder could be 
pivotted out of the way using a 
strong piece of wood. Don't make 
the solutions too obvious but then 
again don't make them 50 
outrageously stupid that no-one 
would be able to solve them. If the 
latter is the case then the player is 
likely to quit and put your adventure 
away to gather dust I 

The objects that solve puzzles 
can be termed "solution objects" 
and all others "collection objects". 
I hi- I,ii:h ( 01.1 d in. 1 -~i 111 !■: 1 1 1 1 ri !_■. hki-' ,1 
gold coin that is needed to complete 
the game. Obviously, the solution 
objects and the actual and location 
obstacles should be placed with care 
as thought must be involved to 
ensure that the solution objects are 
available before the obstacles are 
encountered. It would be no good 
placing the piece of wood to shift the 
boulder somewhere "after" the 
boulder. There is quite a bit more to 



about : 



and c 



rhich I shall c 
start of the next article. For now, 
though, it's your turn to do a bit of 
programming! 

What we neetl to design lor next 
month is an input routine. This Is 
very imporlant because it is how the 
player conveys his commands to the 
compuler and adventure program. 
You could use a standard INPUT 
command but a much better one 
would be specialised to accept only 
certain characters and length of 
input. Have a go at that yourself - I 
shall provide my version next month 
together with routines to get and 
display text and graphics and 
describe the present location. These 
can be adapted for your own use but 
will eventually be found in my 
adventure,- Demad. Splitting up the 
input and analysing it comes later 
on. Until next month, when we shall 
have a true programming session, get 
lil.inniii)' you 1 nun adventure! 
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Dear CDU, 

1 smoke whilst .11 'In keyboard .mil 
Ihis has resulted In m> keyboard 
accumulating ash and going 
haywire. After dismantling the 
computer and blowing nui ihc 
keyboard wilh a foolpump llie 
problem was temporarily rectified. 
However it occurred again after 
aboul a week and required the same 
treatment. There will come a time 
when the problem won't be solved 
in this manner and I wondered if 
you knew of some supplier who can 
supply me wilh a replacement 
keyboard. 

Derrik Nash, The British Forces. 

Dear Derrik, 

There is a company in Birmingham 
that will supply replacement 
keyboards. They are HRS Electronics 
Pk and their address is Garretts 
Green Lane, Birmingham Bll DUE 
The telephone number is :\2'7m 
7575 and the keyboards art- il"). : 
forty pounds (including VA1) for ,1 
C64 keyboard and around twenty 
four pounds for C64C keyboards 
However, you will haye lo contact 
them for the exact prices Vou 'ijv. 
though, be able to get one 1 1» apt 1 
by finding someone who nas an old 
64 that has possibly a number ul 
faulty chips or has been rJ.nriaE.tiJ in 
some other way and is of no use Y:i„ 
could then use the keyboard from 
that computer or alternative v some 
computer stores will ha\i ones left 
from computers that they lavr bet 
asked 10 repair but then 1 h 1- been 
found that it would be 



is able I 



;1 hold 



of one for only five pounds! The besl 
bet though would be to contact HRS. 

Dear CDU, 

I hope you can help me with the 



Commodore m>s"fl dual floppv disk 
drive with my C ommndore t>4 
rnmpuler. Ihe User Manuals says 
that by acquiring ihe Commodore 
M Mi Interface fipan-inn Card it 
is possible to attach an* IrH disk 
drive. So I know that I need an IITF 
interface hut I cannot find any 
supplier lhat stocks these here in 
Holland. Maybe you can help me to 
solve my problem. I would 
appreciate any help or information 
you can give me that can help me to 
use my 8050 dual drive. 

Hans Sjoerds, Holland. 

Dear Hans, 

I am pleased 10 be able to tell you 
that there is a company here in 
England that slock the item that you 
are looking for. They are Meedmore 
Limited and are based at 28 Farriers 
Way, Netherlon, Merseyside, L39 
4X1 The slock number for Ihe 
t on-modore 64 IEEE Interface 
■ >:■ -ion Card is A0141 and il costs 
.■• short of eighty pounds. This 
• ties VAT and postage in ihe UK, 

a '.srifiemenls are made and what 
: usts are incurred by sending lo 
other countries, I hope I have been 
ible 10 set you on your way. 



Dear CDU, 

1 own GEOS u-uii I must say is a 

brilliant paikagc of programs of 

whuh I proudly own most, bul is 
there any way I can have a pound 
sign. II is very annoying nnling a 
letter to someone when you lannut 
print a pound sign. I have created 
my own foni wilh a pound sign hut 
it is nol displayed when you press 
Ihe pound sign key. bul when the 
"at" kes is pressed. I have only just 
found nut thai this -ign appears as .1 
'©' if ynu prinl il oul using (he M Q 
mode or Draft mode. Only on High 



e readers out. 

mode will a pound sign appear. 
Please could you help me. 

Matthew Langner, Hatfield. 

Dear Matthew, 

What you must do is alter the 
appropriate DIP switch on your 
printer so that the BASIC line 
OPEN4,4:PRINT#4,"#":CLOSE4 
produces a pound sign to be 
displayed, Then keeping this swilch 
set like that, which I think is the one 
dealing with international fonls, load 
up GEOS and type your letter. 
Whenever you want a pound sign lo 
be displayed use the hash mark (#). 
Then when you output in NLQ 
mode, the printer should display a 
pound sign instead of the hash mark. 
Thanks go from me lo FSSL for 
|.i!'Vidini; that bil or information. 



Dear CDU, 

I am writing to ask if you could 
solve a little problem I have with a 
program on the CDU disk Volume 3 
Number B. The file is the POPP 
program for the CI 28 computer. The 
problem is that when I load it into 
memory I get an Illegal Quantity 
error in line number ten. 1 hope you 
can solve this for me. 

A.G. Jones, Hull. 

Dear Mr Jones, 

■•■ 11, -iber ten of Ihe said program 

v\ NDOW command. The only 



: c 



e for 1 



■r lhat I 



imagine is that you are attempting to 
.■•■'■ ■.<•■ ihe program in the standard 
forty reilumn mode. This means thai 
■he .jlue for the horizontal widlh of 
the window is reduced to a 
maximum of 39. But the command 
•:«■' 1 1" a width of 79 and therefore, 

modi:, an Illegal Quanlily error will 
be generated. 
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Dear CDU, 

I wonder if you would be good 
enough Id answer the following 
couple of questions. I have recently 
acquired a second CBM1541 drive 
and after a slight repair the machine 
is as good as new. Is it an advantage 
and to what uses can I put it* 

R.I.Pike, lichfield. 



Having a second drive is certainly 
odvJiiragi.fl.ius even though it may not 
seem so al the stan. This will make 
itself increasingly apparent as you buy 
new software or your needs are 
increased and you will find mors and 
more uses for the new drive. Copying 
of disks (your own - not piracy, 
please!) is far quicker using Iwo drives 
because it eliminates the need to keep 
swapping the source and destination 
disks. Also, you have elfin live I v gut 
twice as much space ro access at the 
same time. If using a word -processor 
or spreadsheet you could have the 
main system disk in one drive and 
your work disk in the other. Then if 
the program needed to keep 
accessing the main disk you wouldn't 
need to keep swapping [hem around. 
Also there are many uses for a second 
drive when programming and I am 
sure that more of them will make 



Dear CDU, 

There appears to be some faults on 
the CDU disk that I received recently 
(|une issue). None of the 128 
programs are found by the drive for a 
start. Also when trying the Sprite. Bas 
demo it instructs one to load the 
Sprite Basic program but pressing the 
space bar results in the screen going 
dead, no cursor, no activity. Other 
programs at fault are [he Aleatory 
Music which, after loading, produces 
a syntax error in 17190. The copier 
program is also faulty. After pressing 
either F5 or F7 there is no activity at 
all. With regard to the new menu - I 
do not like it. When using the cursor 
to select a program it is only possihle 
to go down the program list, using 
SHIFT does nol enable on to go hack 
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up the selections again, and I found it 
only too easy to overshoot the 
selected program. I have sent the disk 
back to Select Subscriptions but hope 
you can shed some extra light on the 

E . C . Am es bu ry, West on-5u per-Mare. 

De.ir Mr.Amesbu.ry, 
It certainly sounds as though the disk 
was corrupt and I hope that the 
copy will work when 
it. However, there may be 



Dear CDU, 

The main reason for writing is to find 
out how to get multicolour sprites. 
The user manual does not help much 
(not at all really). I would also like to 
know how to get the computer to 
automatically enter data created 
from a sprite editor program I have 
written. I need to enter about ten 
lines. I hope you can help. 

David Mayes, Ken I. 
Dear David, 



other 



of a 



for 



sprite 



programs not working. The 1 28 ones 
for example. These do nor load using 
some 1 571 drives because they are 
protected. This protection must be 
removed using a disk editor or a 
directory editor before the programs 
will load. Alternatively put the drive 
in 1541 mode. The reason for the 
Sprite. Bas program not working could 
be the fault of a (astload cartridge of 
some description that you have fitted. 
List line 3D - the last statement should 
be SYSG473B. If It is this then the 
computer should reset itself. You will 
have to wait a couple of seconds 
before the power-up message appears. 
Alealory Music can also produce 
errors if a cartridge is active because 
of the way it is "decompressed" out to 
its standard length. If it still produces 
an error when you get it back, fry it 
without anything else other than the 
drive and monitor attached. I cannot 
see what the problem with the menu 
is. It is programmed to respond to the 
SHIFT and cursor down key so that 
upward movement is possible. These 
are all only possible causes for the 
separate errors, of course it may be 
that parts of the disk have been 



controlled by register number 28 in 
the VIC-II chip, location number 
53276. To switch on multicolour 
mode by entering POKE 53276, 
PEEKIS3276) OR 2*N where 'N' is 
the number of the sprite from zero to 
seven inclusive. To switch off 
multicolour mode use POKE 53276, 
PEEK153276) AND 255-[2*N). If you 
understand binary then the eight 
sprites are represented by The eight 
bils of location 53276, sprite zero 
being the far right bit zero, and sprite 
seven being the far left bil seven. 
Thus is you wanted sprites 0,1,4 and 
6 to be multicoloured the value to 
enter would be the decimal 
equivalent of 01010011 which is B3. 
Thus you would type POKE 
53276,83. As for entering the dala, 
there are a number of ways. By far 
the simplest is ro gel Ihe computer to 
print out a line as if voir had typed it, 
then to print a statement such as 
COTO 500 beneath that and then to 
exit the program. Before doing this 
the keyboard buffer is loaded with 
carriage returns. Then when the 



|)|-u S u 



, the 



vill bl- 



ind the GOTO 500 
statement executed which returns fo 
the program. However there is one 
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huge problem with this. Whenever a 
line is entered into the computer's 
memory, all variables are cleared. If 

previous technique is line. The other 
method is too complicated to explain 
here but involves actually playing 



Wth r 



and 



pointers. If you want to slo 
variables then POKE them to some 
location (679-767 are handy) before 
exiting and then retrieve them by 
PEEKtng the same location upon 
returning. I hope that the technique 
is suitable because on the disk you 
will find a program filed as 
"TECHNO INFO" thai will ask you to 
enter a value between I and 100. 
That many random numbers are then 
generated and stored in blocks of 
eight as DATA statements, I have 
fully REMmed the program so that 
you can see what is happening. I 
hope I have been of some assistance. 



Dear CDU, 

I would like to react to two letters I 
read in your May 1990 issue. Maybe 
I can be of some help to the writers. 
My first remark is for Mr. Booth from 
Bristol. He experienced trouble with 
the Power Cartridge. Purely by 
coincidence I met another C64 user 
the very day I received CDU who 
had suffered from similar effects. 
Here is the story: His C64 (old 
model) broke down - one of the 
CIAs blew up, making some 
operatrons very hard. So he bought a 
new one. It worked perfectly until 
he installed the Power Cartridge. 
Without it there was no problem. So 
he switched computers - back to the 
old one. Result - trouble. He 
borrowed another 64 from a friend 
and connected it. Result - system 
going haywire. In a last attempt he 
replaced the power supply block of 
his new 64 with the one of his old 
64. Result - all computers worked 
perfectly (apart from (he one with 
the broken CIA of course). 
Conclusion - the fault might be in 
the power supply. To control this he 
fetched his multimeter and checked 
out the voltages. And here comes 
some confusion I don't understand - 



on the 5 volt supply pin of his oldest 
power supply (which worked) he 
found a voltage of 4.65V and on the 
new supply (the one with the 
problem) he measured 5.05V. 
Anyway my conclusion still is that it 
might be helpful to have your power 
supply checked out, for this may be 
the cause of your trouble. My 
second remark is for Adam Trickett 
of Leeds. He asked if there is a 
GEOS printer driver for the Citizen 
120D. Well, here is some good news 
for him: there is such a specific 
driver, however not in England. I 
would like to seod it to you, bul I 
think that could mean problems 
with respect (o copyrights, for it was 
published in a German magazine, 
64er Sonderheft Nr.28 some time 
ago. But don't panic: if you write a 
letter to their publisher, I am sure 
they would be willing to help you. 
Their address is: Mark! & Technik 
Verlag AG, Hans Pinselstrasse 2, 
B013 Haar bei Munchen, West 
Germany. Now don't think I am 
advertising for your "rivals", for 
64er publishes lots of good articles 
and programs and I often buy their 
magazine at my local newspaper 
shop, but my postman brings me 
CDU every month at home, for 
CDU has the programs on a disk, 
whereas 64er gives me blue fingers! 
Keep up the good work! 

|an Kerkhof, Belgium. 

I cannot thank you enough for all ihis 
information and I hope that 
everything will be sorted out for the 
people that have experienced 
problems with BDL's excellent Power 
Cartridge. I hope Adam 
German! That's a joke of 
would expect that there is 
there that can read English. Thanks 
once again for the info. 



version of Forth designed for writing 

condition and I would like (en 

Raymond Hoben, Dumbarton, 
Scotland. 

Dear Raymond, 

Thanks for your letter. If, Simon, you 
would like to buy this piece of 
software from Raymond at a cost of 
ten pounds ihen I would like you to 
get in touch with me again to confirm 
evetything, I will then pass your 
address on to Raymond and you two 
can take things from there. 



Dear CDU, 

Can you please help me. What I 
would like is for you to ask whether 
any of your readers has a copy of the 
Laser BASIC Compiler for the 64. I 
am willing to pay for it. 

D.Beeley, Manchester. 



Dear CDU, 

With reference to Simon Searle's 
letter requesting a copy of Laser 
BASIC. I have a tape version of White 
lightning which contains BASIC 
LIGHTNING which is almost the 
same as Laser BASIC which Ocean 



Dear CDU, 

With reference to the letter in 
Techno Info from Adam Trickett in 
the May 1990 issue, I think the 
problem may be that the compiler is 
supposed to compile Laser BASIC and 
not standard BASIC programs, 
although I am not sure. I have Laser 
BASIC and 1 have been trying to gel 
hold of the compiler for a while so if 
it is no good to Adam I would like to 
ask if he will set if to me (original 
with instructions please). So if you 
could please print this letter I would 
be extremely grateful. 

M.Le-Vallois, Paisley, Scotland. 

Dear Mr.Beeley/Le-Vallois, 
We seem to have a little conflict here. 
Obviously now, Mr.Beeley, you know 
of someone with the Laser Compiler 
who, for one reason or another, was 
noi over impressed with it. Mr.Le- 
Vallois, you have picked up on a 
possible cause but of course we do 
not know whether Adam Trickett 
really wants to sell this piece of 
software or nof. If both Mr.Beeley and 
Mr.Le-Vallois would please write to 
me telling me of the maximum that 
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they would pay or an amount that software, and if so how much you 
they would want lo pay I would be would want for it. In the meantime, 
grateful. Also Adam, could you please anyone eke who has a copy of if lhat 
they would sell, plea 



for it. I am sure that somehow all 

will work itself out and we may 
n be jblt in satisfy boih Mr.fSeeley 
I look forward lo 



e prepared to sell the with details of how much you would your further corresponded 



TIP OF THE MONTH 

Well all my pleas stein to have paid off bul wt 
only had the following two tip* senl lo us from you 
readers. If anyone else has any piece of information that 
they think may be useful fhen please send it in to us. The 
first one is a little batch of POKEs and comes to you 
courtesy of Mr D.Bee ley in Manchester: 

POKE775,200 will disable the LIST command, and 
POKE775,167 will return to normal 
POKE774,226:POKE775,252 will result in the computer 
resetting itself if the LIST command is entered. 
POKEb49,0 will disable the keyboard, and POKE649,10 
will return to normal. This should be used from within a 
program because otherwise you can't type the second 
POKE to return to normal! 

POKE8U8,254 will prevent the use of RUN/STOP, and 
POKE80B,237 will return it to normal. 



Hit -tconrl tip is sli,;r,llv km.nci and rnori: complex and 
was senl in by Steve Williams, coincidently also from 
Manchester. It concerns the use of CDU MENU KIT 
written by Neil Higgins (Volume 3, Number 2); 

I have found a way to get the menu as the first file on 
your disk without the use of a disk editor. Firstly, take a 
formatted disk and put it in your drive! Then type 10 
REM and press RETURN, then type SAVE "NAME",8 
where NAME represents the name of the program to go 
in the menu. Repeat the save instruction as many times 
as you need, saving each time with a different title for 
each program. Ensure that the title you j-ive matches the 
title from the first part of each program (especially if it is 
in multiple parts). Switch off and then on again before 
the next bit! Load the CDU MENU KIT and replace the 
disk with all your titles on. When the program asks if 
you want to include something you should say yes and 
include them all. Now sort out your colours and when 
you have done that save the finished menu to a different 
newly formatted disk. All you have to do now is save 
each separate program complete with any extra parts 
with the file copier from CDU if you feel that way 
inclined. Then switch off and on again and type 
LOAD """,8,1. Your personalised menu is already al the 
start of your disk-full of goodies. All without the need 
for a directory editor. It may look a little long winded 
when you first look at this but it's not when you get 
stuck in. If you haven't been able to put your menus at 
the start of your disks before because you didn't have a 



directory editor then you have n 



Thanks must go lo both Mr.Beeley and Mr.Williams ft 
those tips. Hopefully some more of you will come u 
with some others now that you see it really is possible I 
i:m your tips published! Please everyone: remember the 
Nl- VV -\l )| )R[ SS i.r >ou haie any programming problen 
or general queries, or if you want to have something 
published in the Tip of the Month section (please mark 
youi envelope with the word TIP), The new address, c 
published last month, is: CDU Techno Info, 11 Cook 
Close, Brownsover, Rugby, Warwickshire, CV21 1 NG. 
Please note that this is only the address for Techno I 
All other correspondence and contributions should be 
sent to the main address lo be found elsewhere in 
|iubli. .ilion. Sec you ..ill a«ain next month! 




,/J 'FAN 

-Sf ^ADVERT IS IN 
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EXPLORING THE 1541 

Learn more about the inner workings of your 1541 disk drive 



S WICKHAM 



Now that you have jjtrrt.-li.nsed your 

1541/1570 disk drlve,what can you 

do with it? Well the simple answer is, 

nothing, until you understand how (See 154! layout). Of these 35 tracks, 

and why it works. By the end of this there's one very important one, this is 



it le. 



ledge 



e gra 



workings of this 'Reclanguli 
Hopefully, your usage of the drive 
will benefit from what you are about 



track 16, Track 18 is known as the 
BAMIBIock allocation map) and and 
the DIRECTORY track. The BAM 
shows us what tracks and sectors 



e world of the 
1541 will probably only use the drive 
for storing programs, perhaps they 
e lhat you i 



ri the Dirs 



Hid tthll. 



ory tr 



drive for s 



. The 



experienced users will by no 1 
saying to themselves: 'Here w 
again, heard it all before'. Befort 
go rushing off to make a cc 
Coffee though, read on. ...It's neve 



about each file that is stored o 
disk. (See 1541 layout). Before we go 
into more detail, opposite is the layout 
of the tracks, and the sectors of the 
1541, together with the sort of 
information that they contain. 



SEQUENTIAL FILE 
FORMAT 

BYTE DEFINITION 

AIL BUT FINAL SECTOR 

0,1 Track and sector of nest 

sequential data block 
2-255 254 bytes of data 

FINAL SECTOR 

0,1 Null ($00), followed by 



number of valid data 

Last bytes of data. Any 
remaining bytes are 
garbage & can be 

ignored 



This article is MAINLY lor the 


FIRST 5ECTOR 


DATA BIOCK 


1541/1570 users, although much of 


0,1 


Track and sector of next 


0,1 


Track and sector of next 


the info is also pertinent to the 1571. 




Mm k in program file 1 




data block 


Where possible, I will give examples 


2,3 


Load address of program 


2-255 


254 bytes of data. Empty 


for both units. [For example, 


4-255 


Ne^l 2=i2 bytes of prg 




records contain SFF lall 


everyone is aware that to 




into slored as in comp 




binary ones) in the first 


communicate with the 1541 you use 




mem, (keywords 




byte followed by $00 (all 


BASIC 2.0 commands, but for the 




tokeni*ed) 




binary zeroes) to the end 


1571 you can also use BASIC 7.0 








of the record. Partially 


commands.) How do you go about 


REMAINING FULL SECTORS 




filled records are padded 
with nulls ($00) 


learning about something like the 


0,1 


Tr.ii.-k and sector of nest 




1541, the first thing you should know 




block in program filel 






is how the information is stored on 


2-255 


Next 254 bytes of prg 


SIDE SECTOR 


the diskettes that you spend your well 




into stored as in comp 


0-1 


Track and sector of nest 


earned money on. To be able to 




mem.( keywords 




side sector block 


understand that, you need to know 




tokenized] 


2 


Side sector number (0-5) 


how a diskette is made up. 






3 


Record length 




FINAl SECTOR 


4-5 


Track and sector of first 


Information is stored on the diskette 


0,1 


Null ($00), followed by 




side sector (number 0) 


on TRACKS. On a standard 1541 disk 




number of valid data 


u-7 


Track and sector of 


there are 35 of these tracks. Each 




bytes in sector 




second side sector 




z-m 


Last bytes of pig info 




[number 11 


SECTORS. The sectors are the areas 




stored as in comp 


8-9 


Track and sector of third 


lhat contain the bytes of data. Each 




mem. (key words 




side sector (number 2) 


sector holds 256 bytes. The tracks are 




tokenized). 


1 0-1 1 


Track and sector of fourth 


numbered from the outside to the 


The end of 


BASIC tile is marked by 




side sector (number .)) 


centre. Therefore, as you get nearer 


three zero bytes in a row. Any 


12-13 


Track and sector of fifth 


the centre of the diskette, the less 


remaining 


bytes in the sector are 






number of sectors each track holds. 


garbage and may be ignored, 


14-15 


Track and sector oi sixth 



FEATURE 



side sector (number 5} 

16-255 Track and seclor pointers 

to 120 data blocks 

DIR FILE FORMAT, TRACK 
1B SECTORS 1-19 

BYTE DEFINITION 



0,1 Track and sector of next 


directory block 


2-31 


lie entry 1 


34-63 


ileeniry2 


66-95 


ile entry 3 


98-1 27 




130-159 


He entry 5 


162-191 


ile entry 6 


194-223 


ile entry 7 


226-255 


lie entry 8 


STRUCTL 


RE OF EACH 


INDIVIDU 


\L DIRECTORY 


ENTRY 




BYTE CON 


ENTS DEFINITION 



File type OR' ed 
with $80 to 
indicate properly 
dosed file, 
(ifOR'edwiih 
$C0 instead, file 
is locked! 
TYPES: 

= DELeled 

1 = SEQuential 

2 = PROGram 

3 = USER 

4 = RELalive 
Track and sector 
of first data block 
File name padded 
with shifted spaces 
Rel file only. Track 
and sector of first 
side sector 

Rel file only. 
Record length 
UNUSED 
Track and sector 
of replacement file 
during an 
@SAVEor@OPEN 
Number of blocks 
in file, stored as a 
two-byte integer 
in normal lo-byle 
hi-byte format 






1 he above inltirm.il on ;i 



l you how 



DISKETTE FORMATS £ LAYOUTS 


Block distribution by Track 




Track Numbers 


Range of Sectors Total Sec S.Srded D .Sided 


HEX DEC 


HEX 


DEC 


HEX DEC 


$01-$I1 01-17 


$00-$1 4 


00-2C 


$15 21 YES YES 


si2-$ia la 


24 


$00-$12 


00-18 


$13 19 YES YES 


$19-$1E 25 


30 


$00-$ 11 


00-17 


$12 18 YES YES 


$lF-$23 31 


35 


$00-$10 00-16 


S11 17 YES YES 


$24-$34 36 


52 


$00-$ 14 


00-2C 


$15 21 NO YES 


$35-$3B 53 


59 


00-$1 2 


00-18 


$13 19 NO YES 


$3C-$41 60 


65 


$00-$ 11 


00-17 


$12 18 NO YES 


$42-546 66 


70 


S00-$10 00-16 


111 17 NO YES 


BAMFORMAT1541 - TRACK 18 SECTOR 


BYTE NUMBER 


CONTENTS 


DEFINITION 





18 




Track of next directory block. Always 18 


1 


1 




Sector of next directory block. Always 1 


2 
3 


65 




ASCII chararacter A indicating 

1541/51/71/4040 formal 

Double ^ideri flag. Ignored on 1 541 


5 
6 
7 






Number of sector available on track 1 
Track 1 , sector 0-7 availability map 
Track 1 , sector B-1 6 availability map 
Track 1, sector 17-23 availability map 
Number of sector available on track 2 


9 






Track 2. sector 0-7 availability map 
Track 2, sector 8-16 availability map 
Track 2, sector 17-23 availability map 






....ETC DOV 


140 






Number of sector available on track 35 
Track 35, sector 0-7 availability map 


143 






Track 35, sector 8-16 availability map 
Track 35, sector 17-23 availability map 


1 44-1 59 






Disk name padded with shifted spaces 




|CHR$(160)I 




160-161 


160 




Shifted space |CHR$(160)| 


162-163 






Disk ID 


164 


160 




Shifted space (CHR$(1 6011 


165-166 






ASCII representation of 2 A which are 
respectively the DOS version (21 format 
type 1540/41/51/71/4040/2030 


167-170 






Shifted spaces |CHR$(1601I 


171-255 






Nulls [CHRSTO),, not used 


1571 DRIVE AS ABOVE EXCEPT 




3 






Double sided flag:$80=Double Sided, 








$00=Slngle Sided 


171-220 






Nulls |CHR$(0)|, not used 


221-237 






Number of sector available track 36-52 
(each sector by each byte) 


238 







Number of sector available track 53 
(always 0, all sectors allocated 


239-244 






Number sector available tk 54-59(each 
tk by each byte) 


245-250 






Number sector 'available tk 60-65(each 
tk by each byte) 


251-255 






Number sector available tk 66-70(each tk 
by each byte) 



each track and sector is made up, and 
what Information is contained therein. 
Later in the article, I will explain just 
HOW the information is written to the 
disk. Before we get loo technical 
though, I wanl to show you some of 
the commands available to you and 
how we use them. The table below 
shows you the various commands 
available, (Using BASIC), both for the 
1541/1570 and for the later version 
1571. After the table I will 
demon si rate exactly how to use each 
one in turn. Using BASIC 2.0 the 
general format is:- OPEN15,B,15: 
PRINT#15,"command":CL05E15 or 
OPEN 1 5,8, I 5, "command 
tetterO:information":CLOSE15. 
(NOTE:- The first 15 in the 
OPEN/CLOSE command is not 
mandatory. This is just the file number 



alio. 



the 



(Normally though 1 5 is n 



HOUSEKEEPING 
COMMANDS 

BASIC 2.0 

NEW "N0:disk name.disk id" 

COPY "C0:new file=old file" 

RENAME "R0;new nam=old name 

SCRATCH "SOifile name" 

VALIDATE "VO" 

INITIALIZE "10" 

BASIC 7.0 

NEW HEADER"di5kname",id,dv 

COPY COPY"old file"TO"new 

file" 
RENAME RENAME"old name'TO" 

SCRATCH 5CRATCH"file name 
VALIDATE COLLECT 
INITIALIZE "10" 

FILE COMMANDS 

BASIC 2.0 

LOAD LOAD"filename",B oi 

LOAD"filename",fl,l 
SAVE SAVE"filename",8 

VERIFY VERIFY"filcname",8 

OPEN OPENfn : B,channel," 

0:filename,file type, 
direction" 
CLOSE CLOSEfn 

PRINT# PRINT#fn,dala list 
CET# CET#fn,variabie list 





INPUTfn,variable list 


FEATURE 


INPUTS 


reserved as the COMMAND channel 






Data transfer over this channel is as 


BASIC 7.0 




follows:- Opening the channe 


BLOAD 


BLOAD"filename" 


(OPEN! 




Bank#,Start address 


Data transfer (PRINT) 


BSAVE 


BSAVE"filename" 
Bank#. Start address TO 


Close the channel (CLOSE) 




end address 


When you initially open the channel 


BOOT 


BOOT~filename" 


you specify a logical file number, thi 


OPEN 


DOPEN#fn, 


number musl be in the range of 1 to 




"filename "(record 


127, the device number of the drive 




length], [W] 


(this is normally 8 for single unilsj 


CLOSE 


DCLOSE#fn 


and a secondary address. (15 for the 


RECORD 


KbCORD#fn. record 


command channel. The logical Fih 




numberl, offset 1 


number is used in any suhscijui-n 


PRINTS 


PRINT#fn,data list 




GETS 


GET#fn,variable list 


commands can be sent until the 


INPUT* 


INPUT#fn,vanable list 


channel is closed. These command 



DIRECT ACCESS 
,1 widely COMMANDS 

BLOCK-ALLOCATE "B-A";0,track; 



BLOCK-EXECUTE 



BUFFER-POINTER 



MEMORY-EXECUTE 



MEMORY-READ 



MEMORY-WRITE 



"B-E";channel, 
0;track,'sector 
"B-F";0;track; 

"B-P";channel; 

byte 

"U1 ";channelfl; 

trackjsector 

"U2";channel,-0; 

traclcsector 

"M-ETHRS 

(<address)CHR$ 

(>address) 

"M-R"CHRS 

(<address)CHRS 

(>address)CHrSS 

(number of bytes) 

"M-W'CHRS 

teaddresslCHRS 

(>address)CHR$ 

(number of bytes) 

CHRSIdata byte) 

CHRSIdata byte) 



USER "Uchar" 

UTILITY LOADER "&0:file name" 

BURST |1571only)"U 

char"+charactei1s) 
Commands intended for the drive are 

Communication with the disk drive 
can be achieved over any 1 of 15 
channels. Channel 15 however is 



NEW - Formatting a diskette 
The command NEW formats a 
diskette, that is to say, it prepares a 
new diskette for receiving data. As in 
all commands, the command word 
NEW can be reduced to a single letter. 
EC N=NEW. R=RENAME. For clarity, 
I will show all commands in their 
condensed format. That is to say that 
instead of OPEN 1 5,8,1 5:PRINT 
#15."NEW:name,id". I will use the 
much shorter method of 
OPEN15,8,)5,"n:name,id". Therefore 
to Format a new diskette we use the 
command:- 

OPEN15,8,15,"N:name,id" 

COPY - Copying files 
This command allows the user to 
copy a file already present on the 
diskette The command is however 
seldom used, it's only real benefit is in 
(he ability to combine several 
SEQUENTIAL files together to make 
one larger file. This method cannot be 
employed on PROGRAM files though. 



RENAME -.Renames a file with a 

This command allows the usi 
change the name of a file on di 
works on all file types. 



tid 



name=olri name* 

SCRATCH - Scratch a file 

This command allows you m 6C1 m 
of any redundant fries. Il has rhi 

scratch more than one file at a time. 

OPEN 1 5,8,1 5,"S:prog 1" 
■ this would get rid of progl only 
aPEms,8,15,*&prqgl,prog 



(Later on you will learn how you can 
RECOVER files thai have been 
scratched by mistake). 

VAUDATE - Validate diskette 

This command allows you to 'Clean 
up' or Validate your diskette. 
Whenever you Scraith a program, the 
program itself is still on the disk. All 
that happens is that the entry for that 
program is removed from the 
directory Validating your diskette 
makes the space of scratche'd files re- 

OPEN 15,8,1 5,"V~ 

INITIALIZE - Initializing the diskette 
The DOS, or Disk operating system, 
requires a BAM, (Block allocation 
map), to be present on each disk. If 
you should change disks in the drive 
when using it, the DOS will not know 
that you have a different disk in the 
drive. Therefore it will be working on 
the old BAM. To combat this, you i 



1541 MEMORY MAP 

DRIVE ADDRESSES 

DEC DESCRIPTION 



e the 
DOS to read the n< 



/BAM. 



s the 



e have dealt with the 
inds for talking to the 
drive, lets go on to the more exciting 
commands. These commands are 



s the 



I Acce 



commands Once you understand the 
concept behind these commands, and 
what they are capable of, then 
programming the drive in BASIC is far 
more entertaining. However, before I 
go into more detail about these 
commands, I feel it is lime we had a 
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$0000 

$0001 

$0002 

$0003 

$0004 

S000b-0007 

$0008-0009 

$OO0A-0OOB 

$O0OC-OOQD 

SOOOE-UOOF 

S0O12-O013 

50014-0015 

$001 6-O01 7 

$0020-0021 

$0030-0031 

$0039 

S003A 
S003D 
S003F 
$0043 

$0047 

$0049 

S004A 

$0051 

$0069 

$006A 

$006F-0070 

$0077 

S0078 

(0079 

S007A 

S007C 

$007D 

$007F 

$0080 

S0081 

$0082 

$0083 

$0084 

S0085 

$008B-008D 

S0094-0095 

S0099-009A 

$009B-009C 

$009D-009E 

$009F-OOAO 

S0OA1 -O0A2 

S0OA3-O0A4 

$OOA5-0OA6 

$00B5-Q0BA 



20-21 

22-2 i 
32-33 



153-154 
155-156 
157-158 

159-160 



Command code for buffer 
Command code for buffer 1 
Command code for buffer 2 
Command code for buffer 3 
Command code for buffer 4 
Track and sector for buffer 
Track and sector for buffer 1 



Tract 



and si 



r ior buffer 2 
t for buffer 3 
r for buffer 4 



Track and sect 

ID fordriveO 
ID for drive 1 



Flag for head transport 

Butler pointer tor disk controller 

Constant 8, mark ior beginning of data block 

Parity ior data buffer 

Drive number for disk controller 

Buffer number for disk controller 

Number of sectors per track for formatting 

Constant 7. mark for begining of data block 

Stack painter 

Step counter for head transport 

uck number for formatting 



Step size for st 
Number of read at 



(10) 



mpts( 



Devici 



l.iu for li: 



■1 I I/O) 



Flag for talk (I/O) 

Flag for ATN from serial bus receiving 

Flag for EOI from serial bus 

Drive number 

Track number 

Sector number 

Channel number 

Secondary address 

Secondary address 

Data byte 

Work storage ior division 

Actu.nl butter pointer 

Address of buffer $0300 

Address of buffer 1 I040D 

Address of buffer 2 S0500 

Address of buffer 3 $0600 

Address of buffer 4 $0700 

Pointer to inpul buffer S0200 

Pointer to buffer error message S02D5 

Record number LO, block number LO 



SOOBB-OOCO 


187-192 


Record number HI, block number HI 


S0OC1-O0C6 


193-198 


Wrile pointer for FIEL file 


SGOC7-O0CC 


1 99-204 


Record length for REL file 


JOOD4 


212 


Pointer in record for REL file 


$OGDS 


213 


Side sector number 


SO0D6 


214 


Pointer to data block in side sector 


suod; 


215 


Pointer to record in REL file 


S0OE7 


231 


File type 


$00F9 


249 


Buffer number 


$0100-0145 


256-325 


Stack 


$0200-0228 


512-5S2 


Buffer for command siring 


$024A 


586 


Hie type 


$0258 


600 


Record length 


$0259 


601 


track side-sector 


I025A 


602 


.Sector side-sector 


$0274 


62S 


1 enj'.th i,i input line 


$0273 


632 


Number of file names 


$0297 


663 


File control method 


$0280-0284 


640-644 


Track of a file 


$0285-0289 


645-649 


Sector of a file 


$02D5-02F9 


725-761 


Buffer for error messages 


$02FA-02FC 


762-764 


Number of free blocks 


$0300-03 FF 


768-1023 


Buffer 


J0400-04FF 


1024-1279 


Buffer 1 


S050O-O5 FF 


1280-1535 


Buffer 2 


S0600-06FF 


1536-1791 


Buffer 3 


JO7OO-07FF 


1792-2047 


Buffer 4 



look at the 'Memory Map' of [he 
1 541 . To be able to program (he drive 

efficiently, you will need to know M's 
inner workings better. This is very 

experiment with M/C programs. 

Right now, lei's go on to the 
'Direct Access Commands'. These 
commands will all be in BASIC, 
(Machine Coder's be patient). 

Looking at the memory map, you 
can see that there are 5 buffers. 
However, only 4 are free for your use. 
(Buffer 4 is normally used for the 
BAM). Also please note that when 
using Seq and Rel files at the same 
lime, buffer 3 is also not available 
because the Directory uses it. When 
you wish to use a buffer, you first 
have to OPEN a channel and specify 
which buffer you wish to use. For 
example OPEN 1 ,B,2,"#2" would 
open the channel to Buffer number 2. 
However it is good practice to not 
specify the actual buffer number but 
let the DOS select it for you. You 
achieve this by OPENing x,x,x,"#". If 
your selected buffer contains 
Alphanumeric Data, and is not over 



H8 chars in length. You can use the 
INPUT# command. (Providing the 
data is separated by a carriage return). 
Otherwise you have to use the GET* 
command. Remember though, that 
when using GETff it does not allow for 
null values, therefore we have to 
check for it via 

IFAS=""THENA$=CHR$(0). 

Before we go any further there are 
4 things you must remember: - 

1 . The PRINT* statement sent to the 
command channel 1 5, sends a 
direct access command to the DOS 

2. A PRINT* statement to channels 
2 through to 1 4 sends data to a 
buffer. 

3. An INPUT* or GET* statement to 
channel 15 returns any error 
messages. 

4. An INPUT# or GETS statement to 
channels 2 through 14 reads data 
from a buffer. 

The Block-read command tells the 
1541 to read a sector from ihe disk 
into your openend buffer. (Strictly 
speaking this is known as a DIRECT 
ACCESS FILE). Because the tirst byte 



of I he block does not gel read with the 
Hhi !■ iv, ill iiraii; 'il r hi'. i. (hnim.irnl 
can lie shortened to U1 or B-R. The 
Block-write command allows us to 
copy the buffer contents onto the 
desired sector on the disk. Block-read 
can bu shortened to B-W or U2. 
Therefore, the obvious advantage to 
this command is to READ dafa inlo a 
buffer, alter it, then re-write it back to 
the disk. The Block-Allocate, or B-A 
command allows the user to reserve 
blocks on a disk The main purpose of 
this command is to prevent data from 
being overwritten. The Block-free or 
B-F command is the opposite to the B- 
A command. It tells the ihe BAM 
which blocks to make available. The 
Buffer- pointer command, shortened to 
B-P is to tell the DOS just where you 
wish to start reading or writing data 
to/from. 

The Block-execute, shortened to 
B-E is quite a powerful command. In 
essence, you read a sector from the 
disk Into your previously opened 
buffer. The contents are then executed 
as a machine code program from 
within the buffer. In practice when 
using this command, you specify the 
butter number in the OPEN command 

Along with the Direct access 
commands above, you have a few 
commands that allow you to access 
the DOS. (Disk Operating System). 
These are: A.Memory-read 
B. Memory-write and Memory- 
execute, shortened to M-R.M-W and 
M-E respectively. 

I will now give a few examples of 

operation. Feel free to experiment, bul 
always make sure that you work on 
disk with no important data on it. 

('Mistakes DO happen). 

NOTE:- When using the D/A 
commands, there are fwo methods 
available. Either may be used 
depending upon your own 
preference:- 

Method A is PRINTS15, 
"U1 :"channel number;drive 

Method B is PRINT#15,"U1 
channel number drive" 

If using method B remember to 
leave a space between each item 
inside the quotation marks. 
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BLOCK READ BUFFER POINTER 

Suppose you wished to follow a Suppose you wish lo read (he diskette 

program through on the disk by track name ircim within a program. As you 

and sector without actually reading know the name starts at position 144 

the data. To do this you need to of track 1 6, sector 0. Normally you 

follow the path of the Link' bytes, would have to read the first 143 bytes 

That is the 2 bytes at the start of each and ignore them. However the .DOS 

block that tells you the track and has an easier way. You can point to 

setter of the next block. See Fig. 1. any position within the buffer by the 



B-P command The bytes are 
numbered 0-255 in the buffer, the 
buffer pointer can be set to zero 
automatically by the use of the U1 
command though. See Fig. 2. 



1 OPENH,8,15 


; Opens the command 




channel 


2 OPEN4,8,4,"r 


;Openslhe direct access 




fi le.( no s|iecific buffer) 


3 INPUT'Track and sector" 


;TR,SE 


4 PRINT#ft,"U1:"4;0;TR;5E 


/Reads contents of 




di-.'ii-il ruck/Sector into 




buffer 


5 CETS4.TS.SS 


;Reads the first two bytes 




of the buffer 


6 TR=ASC(T$+CHR$(Oi):SE=ASC(SS-fCHR$(0)) 


:G invert;; string variable 




!>> iivit'^ei. allowing for 




null string 


7 IRR=0THENCLOSE4:CLOSEB:END 


:lf last track then finish 


8 PRINTTrack number is: "TR," Sector number is: "SE 


; print them out 


9 COT04 


,'Repeal process 




FIGURE 1 




1 OPE NH, 8, 15 ;Open command channel 


2 OPEN4,8,4,"F ;Open ( 


reel access file 


3 PRINT#8,"U1:"4;Q;1B;0 ;Read contents of desired 


Track/se 


lor ink) buffer 


4 PRINT#B,"B-P:"4;144 ;Point to 


whiTr we want to start 


reading from 


5 FORX=l TOl 6 ;Length of disk name 


6 GET#4,X$:IFX$=CHRJ(160)THENfl ;lf shifted space end 


7 PRINTX$:NEXT ; print on 


t,read next letter 


8 CLOSE4 :CLOSEB:END 




FIGURE 2 




1 OPEN6,8,1S 




2 OPEN4.8,4,"#" 




3 PRINT#B,"U1:"4, i 0;1ft0 




4 PRINT#B."B-p:"4;144 




S X$="NEW DISK NAME" 




6 IFLEN(XJ)<16THENXS=X$+CHRS(160kCOTOC 




7 PRINT#4,X$; 


;Lhi:ini>e the contents 




of the buffer 


8 PRINT#H,"U2:"4;0;1B;0 


Write contents back 

to disk 

;Re-initialize drive 
and finish 


9 PRINT#fi,"l":a05E4:CLOSE6:END 




FIGURE 3 



BLOCK- WRITE 

Block-write, is used 
with [he block-reat 

buffer onto the disk 



the c 



tand. I 



ly desired 
loes NOT 

alter the contents of the buffer.iYou do 
this task yourself). In the following 

example we will lir i han.cjiip the disk 
name that we read wish the previous 
i-v.implt-. See Fig. 3 



BLOCK-ALLOCATE 

When using Program, Sequential or 
Relative files on a disk, the BAM is 
being constantly updated as to blocks 
that are allocated. This prevents 
blocks from being overwritten. 
However, when we use Direct Access 
files, these are NOT allocated in the 
BAM, therefore there is a danger that 
they could be over-written. To 
prevent this from happening we can 
use the Block-Allocate command If 
we try to Allocate a block that has 
already been allocated, we will be 
given the error message 65,NO 
BLOCK,T,S (T and S are the next 
higher numbered free blocks 
available). 

The syntax for using the Block 






The follov 



allocated in the BAM 



ng example 
ir 5 as being 



BLOCK-FREE 

As indicated by it's name, this 
command frees any allocated blocks 

and marts them in the BAM as being 

If you wished to make the above 
track and sector free to use you would 
use the following 













NOTE: Allocating and treeing blocks 


CHR$(lO) is the low byte of the 


FEATURE 






commands, fust what exactly is possible 






has an effect only on blocks that are 


address in DOS that is to be read. 


The following table list jusl a few ideas 




used by Prg.seq and rel files by the 


CHRS(HI) is Ihe high byte of the 


that readily spring lo mind:- 




DOS. The B-W and B-R commands 


address in DOS lhat is to be read. 






do not check [he BAM before 


CHRgf number) is the OPTIONAL 


A. You can manipulate the sectors 




overwriting blocks. Using these 


extra parameter indicating how many 


ami change the BAM 




1 commands you can write to blocks 


bytes lo read. 










marked as allocated in the BAM. If, 


In the following two examples, 


Directory 




for instance, you have a disk thai 


example 1 shows how to read how 


C. You can make changes to files 




contains only Direct access files, it is 


many free blocks are remaining on 


D. You can protect files from 




unnecessary to allocate written blocks 


the disk. Example 2 shows how to 


accidental erasure 




because no other files will be written 


read the disk name. 


E. YoucanCL05E1ilesthatareslill 




on the diskette. Therefore in this case 




OPENed 




you could use"the directory blocks in 


! OPEN8.8.15 


F. You can read and alter any 5a ti >r 




track 18 and therefore have 672 


2 PRINT#B,"M-R"CHR$C>5u) 


that you desire 




blocks available on the diskette. 


CHRSI2I 


G. You can prevent directories from 




To gfve you an example oi the use 


3 GET#8,X$:IFXS=""THENX$= 


being viewed 




of this, One could store a menu 


CHR$(0) 


H. You can prevent dire [<>ric- in mi 




program onto track IB, thus space on 


4 PRINT#B,*M-R"CHR$(252] 


being loaded into memory 




the diskette is nut wasted by the 


CHR$(2) 


1. You can recover lust or damaged 




menu. 


5 CET#B,Y$:IFYS=""THENY$=CHR 


files 






$10) 


|. You can create data struilures lhat 






6 PRINTA5C(XS)+2S6"ASC(YS) 


the DOS would nol normally 




BLOCK-EXECUTE 


7 CLOSES 


recognise 




Block-execute is used when you wish 




<. You could place a menu program 




to read a block from the disk into a 


1 OPENB.8,15 


within llie directory track.thus 
saving space 




buffer then execute the contents as a 


2 PRINT#8,"M-R"CHK$(144)CHR$ 




machine code program. The syntax 


(7)CHRSI1f.) 


L. You could put a simple form of 




lor the command is: B-E channel drive 
track sector. When using the B-E 


3 INPUT#8,X.$ 

4 PRINT\$ 


'Protection' on the disk to prevent 

illegal pirating ola tile. 




command, the buffer number is 


5 CLOSE8 




usually given in the OPEN command, 




Really the IM is boundless. Only your 




just in case the M/C prog is not 


Memory write is the complimentary 


own imagination will set the limits of 




relocatable. IE: OPEN4,B,4,"#2". 


command to Memory read. Writing can 


what can be achieved by the use of these 






only be accomplished to DOS Ram, 


commands, 1 cannot stress the 




1 OPENB,8,15 


page zero, stack and the buffers. It is 


mponance of making sure you do not 




2 OPEN4,8,4,"#2~ 


possible to send more than 1 byte with 


use important disks for your experiments. 




3 PRINT#8,"B-E:"4;El;14;6 


this i ommnnd ihe command syntax is 


As you are no doubt aware, the 1 S4I 
uses the OCR, (Group Coded Recording), 






as follows: 




This would read the contents of track 14, 




method of storing (lata onto Ihe disk. II 




sector 6 The B-E command is used in 


M-WCHRS(LO)CHRStHI) 


you want to know more ahoul thi^ 




conjunction with the B-R and Memory 


CHR$(NUMBER}CHR$[DATA) 


method, 1 refer you to 'Your 




Execute commands that follow. 


CHRSIDATAIeicetc... 


Commodore', Issue |UNE 1'JtSEi, page 

75-77. All 1 will say on the subject is thai 




MEMORY COMMANDS 

There are three memory commands 


Finally, the Memory execute command 


by using this method, more information 




will ca [1 up and execute a machine rode 


can be stored on the disk than you think 




that we will deal with. They are 


program that resides in DOS memory. 


5 possible. 




Memory Read, (M-R) Memory write, 


The routine MUST end with an RTS. The 


1 hope that this article as given you a 




(M-W) and Memory execute, (M-EI. 


syntax for the command is as follows:- 


letter understanding of the 1 541 , and of 




All these commands pre-supposes are 




raw to use it There are many things thai 




knowledge of the inner workings of 


M-E CHRS(LO) CHRS(HI) 


have left out, but tltese are all covered 




the DOS and a knowledge of 




ny the many publications thai you can 




G502/6510code. 


You can not only execute your own 


buy. There is not enough space here lo 




The syntax for the Memory read 


routines written with the use of the M-W 










command is:- 


command, but also the DOS ROM 


istings of some of the programs in this 






So now that we have skirted the 


ssued, and of previous issues. Practice, 
ixperiment but above all else.. .Have 




M-RCHR$(LO)CHR$[HII 


-> 


|(CHRS(number)l 


subject of Direct Access and Memory 


fun!!! 
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KEYNES, MK11 : 



(0908)569819 



FOOTBALL BOXF0RM £14.95 cass £17.95 disk 

Nol a gimmicky plaything but a genuine statistical analysis ol 
football form ttie sole objective of which is to improve the chances 
of winning on ttie pools or fixed odds. Written by a pools expert 
the program has forecast over 50% more draws than would 
be expected by chance. Homes, aways & draws are shown in 
order of merit and true odds given lor every match. Merit tables 
show at a glance the teams currently in form and those having a 
lean spell. Separate AUSTRALIAN POOLS program included in the 

RACING BOXFORM & HANDICAP WINNER 
£14.95 cass £17.95 disk 

Two programmes for the price of one. Boxform weighs up a race by 
considering the many facets of form, Easily amended lo suit the 
user's ideas. HANDICAP WINNER shows (he value for money bets. 
Over 1000 winners every year and ON DERBY DAY 1990 THE 
PROGRAM GAVE THE WINNERS OF 7 OUT OF 9 HANDICAPS. 20/1 
10/1 7/1 11/2 4/1 4/1 6/4. PROBABLY THE BEST DAY'S RESULTS 
EVER ACHIEVED, WITH OR WITHOUT A COMPUTER. 



Why pay inflated prices? BOXoft CLEVER the same - get the BEST 

Advertised for five years in the sporting and computer press, 

BOXOFT (CDU), 65 Allans Meadow, Neston, 

South Wlrral, L64 9SQ 

Cheque/RO./Access/Visa Tel: 051-336-2668 (24 hrs) 




FULL TERMS 

AND CONDITIONS 

ARE AVAILABLE 

ON REQUEST 
TO ADVERTISE 
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(0908)569819 
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PLEASE DEBIT MY ACCESS/VISA CARD N I 



Adventure 



Great C64 & 128 Cassette Games Offer 
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Fed up with listings, want a break from programming? Then 

we've got just the thing for you. 

Were offering the following games on two cassettes at 

the ridiculously low price of £3 (for both) including 

post and packing. 

So what's on offer? 

Flimbo's quest, Finders keepers, Kentilla, Logic, Microdot, 

Rainbow chaser, Spots all these plus instructions. 

Al you have to do is fill in the coupon, (photocopies 

accepted) and return it to 

ALPHAVITE PUBLICATIONS Ltd, 20 Potters Lane, Kiln Farm, 
Milton Keynes MK11 3HF. 



I enclose my cheque/postal order lor £3 made payable to ALPHAVITE PUBLICATIONS LTD. 
Or debit my Access/Visa Number rj I I I I I I I I [ 1 

Expiry Date Signature 

Name Address 



...Postcode... 



Allow 28 days for delivery 
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